Function

GLibclear_list

Declaration 

void
g_clear_list (
  GList** list_ptr,
  GDestroyNotify destroy
)

Description

Clears a pointer to a GList, freeing it and, optionally, freeing its elements using destroy.

list_ptr must be a valid pointer. If list_ptr points to a null GList, this does nothing.

Available since:2.64
This function is not directly available to language bindings

Parameters

list_ptr A list of gpointer
 

A GList return location.
 The data is owned by the caller of the function.
destroy GDestroyNotify
 

The function to pass to g_list_free_full() or NULL to not free elements.
 The argument can be NULL.