VariantBuilder

Object Hierarchy:

Description:

[ Compact ]
[ Version ( since = "2.24" ) ]
[ CCode ( ref_function = "g_variant_builder_ref" , type_id = "G_TYPE_VARIANT_BUILDER" , unref_function = "g_variant_builder_unref" ) ]
public class VariantBuilder

A utility type for constructing container-type Variant instances.

This is an opaque structure and may only be accessed using the following functions.

VariantBuilder is not threadsafe in any way. Do not attempt to access it from more than one thread.

Example: VariantBuilder:

public static int main (string[] args) {
    GLib.Variant? val = null;
    string? key = null;

	VariantBuilder builder = new VariantBuilder (new VariantType ("a{sv}") );
	builder.add ("{sv}", "str1", new Variant.string ("str"));
	builder.add ("{sv}", "str2", new Variant.int16 (10));
	builder.add ("{sv}", "str4", new Variant.int32 (10));
	builder.add ("{sv}", "str5", new Variant.int64 (10));

	Variant dictionary = builder.end ();

	VariantIter iter = dictionary.iterator ();

	while (iter.next ("{sv}", out key, out val)) {
		print ("Item '%s' has type '%s'\n", key, val.get_type_string ());
	}

	return 0;
}

valac --pkg glib-2.0 GLib.VariantBuilder.vala

Namespace: GLib

Package: glib-2.0

Content:

Creation methods:

public VariantBuilder (VariantType type)
Allocates and initialises a new VariantBuilder.

Methods:

public void add (string format_string, ...)
Adds to a VariantBuilder.
public void add_value (Variant value)
Adds value to this.
public void close ()
Closes the subcontainer inside the given this that was opened by the most recent call to open.
public Variant end ()
Ends the builder process and returns the constructed value.
public void open (VariantType type)
Opens a subcontainer inside the given this .