array_resize

With this function you can resize an existing array dimension to a new size. You supply the array to be resized as well as the new number of indices for the array, and the function will resize that array. Note that this function is designed for resizing an array down to a smaller length as you can resize up by simply setting a new index in the array. That said, if you do use it to size up an array, any new indices will be set to the default value of 0.

This function can also be used for multi-dimension arrays, as long as you specify which dimension you want to resize when you supply the array index, following this pattern:

// Resize the first dimension of the array
array_resize(my_array, 10);

// Resize the second dimension of the array (only for the first slot)
array_resize(my_array[0], 10);

// Resize the third dimension of the array (only for the first slots)
array_resize(my_array[0][0], 10);

// ...and so on.

The code states that only the first slot of the second dimension is resized, since the slots in any given array dimension are not interconnected and can have different sizes; for example:

array_resize(my_array[0], 10);
array_resize(my_array[1], 22);

In the above code, the length of the array's second dimension is 10 in the first slot but 22 in the second slot.

Syntax:

array_resize(array_index, new_size);

Returns:

N/A

Example:

if array_length(a) > 10
{
    array_resize(a, 10);
}

The above code checks the length of an array and if it has more than 10 indices, it is resized.