Function

GLibListfree_full

since: 2.28

Declaration

void
g_list_free_full (
  GList* list,
  GDestroyNotify free_func
)

Description

Convenience method, which frees all the memory used by a GList, and calls free_func on every element’s data.

free_func must not modify the list (eg, by removing the freed element from it).

It can be combined with g_steal_pointer() to ensure the list head pointer is not left dangling — this also has the nice property that the head pointer is cleared before any of the list elements are freed, to prevent double frees from free_func:

GList *list_of_owned_things = …;  /<!-- -->* (transfer full) (element-type GObject) *<!-- -->/
g_list_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref);

Available since: 2.28

This function is not directly available to language bindings.

Parameters

list

Type: A list of gpointer

The first link of a GList.

The data is owned by the caller of the function.

free_func

Type: GDestroyNotify

The function to be called to free each element’s data.