ArrayCreate

Syntax

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

Usage

Size of each array entry in cells

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.

Description

Creates a handle to a dynamically sized 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.

• 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.