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