ASize()
Increase or decrease the size of an array.
Syntax
ASize(<aTarget>, <nLength>) --> aTarget
Arguments
<aTarget> is the array to increase or decrease in size.
<nLength> is the new size of the array.
Returns
ASize() returns a reference to the target array, <aTarget>.
Description
ASize() is an array function that changes the size of the <aTarget> array. The array is shortened or lengthened to match the specified length. If the array is shortened, elements at the end of the array are lost. If the array is lengthened, new elements are added to the end of the array and assigned NIL.
ASize() is similar to AAdd() which adds one new element to the end of an array and optionally assigns a new value at the same time.
Examples
This example creates an array of 1 element, increases it by 3 elements, then decreases it again by 1 element:
aArray := { 1 }
ASize(aArray, 4)
* Result: aArray is { 1, NIL, NIL, NIL }
ASize(aArray, 1)
* Result: aArray is { 1 }
____________________________
Related Topics:
|