Advertisements
ASIZE()
Adjust the size of an array
Syntax
ASIZE(<aArray>, <nLen>) --> aTarget
Arguments
<aArray> Name of array to be dynamically altered
<nLen> Numeric value representing the new size of <aArray>
Returns
<aTarget> an array pointer reference to <aTarget>.
Description
This function will dynamically increase or decrease the size of <aArray> by adjusting the length of the array to <nLen> subscript positions.
If the length of the array <aArray> is shortened, those former subscript positions are lost. If the length of the array is lengthened a NIL value is assigned to the new subscript position.
Examples
LOCAL aArray := { 1 } // Result: aArray is { 1 }
ASize( aArray, 3 ) // Result: aArray is { 1, NIL, NIL }
ASize( aArray, 1 ) // Result: aArray is { 1 }
Compliance
If HB_COMPAT_C53 is defined, the function generates an Error, else it will return the array itself.
Files
Library is vm
Seealso
AADD(), ADEL(), AFILL(), AINS()
Advertisements