# 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

- AADD()
- ADEL()
- AFILL()
- AINS()