GLib.List.free_full
Description: Reference for GLib.List.free_full

### Function

# GLib Listfree_full

since: 2.28

#### Declaration [src]

    void
    g_list_free_full (
      GList* list,
      GDestroyNotify free_func
    )

#### Description [src]

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.