wl_array man page

wl_array

Synopsis

#include <wayland-util.h>

Public Member Functions

void wl_array_init (struct wl_array *array)
void wl_array_release (struct wl_array *array)
void * wl_array_add (struct wl_array *array, size_t size)
int wl_array_copy (struct wl_array *array, struct wl_array *source)

Data Fields

size_t size
size_t alloc
void * data

Detailed Description

Dynamic array

A wl_array is a dynamic array that can only grow until released. It is intended for relatively small allocations whose size is variable or not known in advance. While construction of a wl_array does not require all elements to be of the same size, wl_array_for_each() does require all elements to have the same type and size.

Member Function Documentation

void * wl_array_add (struct wl_array * array, size_t size)

Increases the size of the array by size bytes.

Parameters:

array Array whose size is to be increased
size Number of bytes to increase the size of the array by

Returns:

A pointer to the beginning of the newly appended space, or NULL when resizing fails.

int wl_array_copy (struct wl_array * array, struct wl_array * source)

Copies the contents of source to array.

Parameters:

array Destination array to copy to
source Source array to copy from

Returns:

0 on success, or -1 on failure

void wl_array_init (struct wl_array * array)

Initializes the array.

Parameters:

array Array to initialize

void wl_array_release (struct wl_array * array)

Releases the array data.

Note:

Leaves the array in an invalid state.

Parameters:

array Array whose data is to be released

Field Documentation

size_t wl_array::alloc

Allocated space

void* wl_array::data

Array data

size_t wl_array::size

Array size

Author

Generated automatically by Doxygen for Wayland from the source code.

Referenced By

The man pages wl_array_add(3), wl_array_copy(3), wl_array_for_each(3), wl_array_init(3) and wl_array_release(3) are aliases of wl_array(3).

Wed Aug 9 2017 Version 1.14.0 Wayland