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 .
- Description
- This function will dynamically increase or decrease the size of by adjusting the length of the array to subscript positions.
- If the length of the array 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
- aArray := { 1 } // Result: aArray is { 1 }
- ASIZE(aArray, 3) // Result: aArray is { 1, NIL, NIL }
- ASIZE(aArray, 1) // Result: aArray is { 1 }
- Status
Ready
- Compliance
- If HB_COMPAT_C53 is defined, the function generates an Error, else it will return the array itself.
- Files
- Library is vm
- See Also