GLib.Array.new_take
Description: Reference for GLib.Array.new_take

### Function

# GLib Arraynew_take

since: 2.76

#### Declaration [src]

    GArray*
    g_array_new_take (
      gpointer data,
      gsize len,
      gboolean clear,
      gsize element_size
    )

#### Description [src]

Creates a new `GArray` with `data` as array data, `len` as length and a reference count of 1.

This avoids having to copy the data manually, when it can just be inherited. After this call, `data` belongs to the `GArray` and may no longer be modified by the caller. The memory of `data` has to be dynamically allocated and will eventually be freed with g_free().

In case the elements need to be cleared when the array is freed, use `g_array_set_clear_func()` to set a `GDestroyNotify` function to perform such task.

Do not use it if `len` or `element_size` are greater than `G_MAXUINT`. `GArray` stores the length of its data in #guint, which may be shorter than #gsize.

Available since: 2.76

This function is not directly available to language bindings.

#### Parameters

`data`

  Type: An array of `gpointer`

  An array of elements of `element_size`, or `NULL` for an empty array.

  The length of the array is specified in the `len` argument.

`len`

  Type: `gsize`

  The number of elements in `data`.

`clear`

  Type: `gboolean`

  `TRUE` if `GArray` elements should be automatically cleared to 0 when they are allocated.

`element_size`

  Type: `gsize`

  The size of each element in bytes.

#### Return value

Type: An array of `gpointer`

A new `GArray`.

The caller of the function takes ownership of the data, and is responsible for freeing it.