next_value


Description:

public Variant? next_value ()

Gets the next item in the container.

If no more items remain then null is returned.

Use g_variant_unref to drop your reference on the return value when you no longer need it.

Here is an example for iterating with next_value:

  // recursively iterate a container
void
iterate_container_recursive (GVariant *container)
{
GVariantIter iter;
GVariant *child;

g_variant_iter_init (&iter, container);
while ((child = g_variant_iter_next_value (&iter)))
{
g_print ("type '%s'\n", g_variant_get_type_string (child));

if (g_variant_is_container (child))
iterate_container_recursive (child);

g_variant_unref (child);
}
}

Parameters:

this

a VariantIter

Returns:

a Variant, or null