Click above to get retro games delivered to your door ever month!

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