Method

GWeatherLocationnext_child

Declaration [src]

GWeatherLocation*
gweather_location_next_child (
  GWeatherLocation* loc,
  GWeatherLocation* child
)

Description [src]

Allows iterating all children of a location.

Pass NULL to get the first child, and any child to get the next one.

Note that the reference to child is taken, meaning iterating all children is as simple as:

  g_autoptr (GWeatherLocation) child = NULL;
  while ((child = gweather_location_next_child (location, child)))
    {
       // Do something with child
    }

Parameters

`child`	`GWeatherLocation`
	The next child.
	The argument can be `NULL`.
	The instance takes ownership of the data, and is responsible for freeing it.

Return value

Returns:	`GWeatherLocation`
	The next child, if one exists.
	The caller of the method takes ownership of the data, and is responsible for freeing it.
	The return value can be `NULL`.