Class

GLib-2.0 ▶ GLib ▶ VariantBuilder

A utility class for building complex GVariant structures incrementally.

VariantBuilder is useful when you need to construct variants dynamically or when dealing with complex nested structures. It provides a way to build variants step by step rather than constructing the entire structure at once.

// Building an array of variants
const builder = new GLib.VariantBuilder(new GLib.VariantType('av'));
builder.add_value(GLib.Variant.new_string('first'));
builder.add_value(GLib.Variant.new_int32(42));
builder.add_value(GLib.Variant.new_boolean(true));
const arrayVariant = builder.end(); // → Variant<'av'>

// Building a dictionary incrementally
const dictBuilder = new GLib.VariantBuilder(new GLib.VariantType('a{sv}'));
dictBuilder.add_value(GLib.Variant.new_dict_entry(
  GLib.Variant.new_string('name'),
  GLib.Variant.new_variant(GLib.Variant.new_string('Mario'))
));
const dict = dictBuilder.end();

Type Parameters

  • S extends string = "a*"
Index
constructor
$gtype
add_value close end open ref unref new
$gtype: GType<GLib.VariantBuilder<"a*">>