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