Function

GLibclear_slist

since: 2.64

Declaration

void
g_clear_slist (
  GSList** slist_ptr,
  GDestroyNotify destroy
)

Description

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

slist_ptr must be a valid pointer. If slist_ptr points to a null GSList, this does nothing.

Available since: 2.64

This function is not directly available to language bindings.

Parameters

slist_ptr

Type: A list of gpointer

A GSList return location.

The data is owned by the caller of the function.
destroy

Type: GDestroyNotify

The function to pass to g_slist_free_full() or NULL to not free elements.

The argument can be NULL.