native

ArrayCreate

Syntax

native Array:ArrayCreate(cellsize = 1, reserved = 32);

Description

Creates a handle to a dynamically sized array.

Parameters

cellsize	Size of each array entry in cells
reserved	Pre-allocates space in the array for the specified number of items. The items are not valid to read or set until they have actually been pushed into the array.

Note

It is very important that the provided cellsize matches up with the
buffer sizes that are passed with subsequent Array[Get|Set|Push] calls.

Note

Initially the "reserved" parameter was intended to create blank entries
that would immediately be usable with Array[Get|Set] functions. This
functionality was never working as intended, and can now be achieved
using ArrayResize().

Return

New array handle, which must be freed via ArrayDestroy()

Error

If an invalid cellsize is provided an error will be
thrown.