GLib.clear_list
Description: Reference for GLib.clear_list

### Function

# GLibclear_list

since: 2.64

#### 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`

  Type: A list of `gpointer`

  A `GList` return location.

  The data is owned by the caller of the function.

`destroy`

  Type: `GDestroyNotify`

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

  The argument can be `NULL`.