Method

JsonObjectIternext

Declaration [src]

gboolean
json_object_iter_next (
  JsonObjectIter* iter,
  const gchar** member_name,
  JsonNode** member_node
)

Description [src]

Advances the iterator and retrieves the next member in the object.

If the end of the object is reached, FALSE is returned and member_name and member_node are set to invalid values. After that point, the iter is invalid.

The order in which members are returned by the iterator is undefined. The iterator is invalidated if the object is modified during iteration.

You must use this function with an iterator initialized with json_object_iter_init(); using this function with an iterator initialized with json_object_iter_init_ordered() yields undefined behavior.

See also: json_object_iter_next_ordered()

Available since:1.2

Parameters

member_name const gchar**
 

Return location for the member name, or NULL to ignore.

 The argument will be set by the function.
 The argument can be NULL.
 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
member_node JsonNode
 

Return location for the member value, or NULL to ignore.

 The argument will be set by the function.
 The argument can be NULL.
 The data is owned by the caller of the function.

Return value

Returns: gboolean
 

TRUE if member_name and member_node are valid; FALSE if there are no more members.