ASIZE()

Ajusta (aumenta ó decrementa) el tamaño de un array

Syntax

ASIZE(<aDestino>, <nLongitud>) --> aDestino

Arguments

<aDestino> es el nombre del array a ser dinámicamente alterado

<nLongitud> es el valor Numérico del nuevo tamaño de <aDestino>

Returns

ASIZE() retorna una referencia al array <aDestino>.

Description

Esta función dinámicamente incrementa ó decrementa el tamaño del array <aDestino> ajustando la longitud del array a <nLongitud> posiciones.

Si la longitud del array <aDestino> is acortada, aquellos elementos al final se pierden. Si la longitud del array es alargada un valor NIL es asignado a los elementos en las nuevas posiciones.
Examples
      *  El siguiente ejemplo crea un array con un sólo elemento, luego lo
         agranda y luego lo vuelve al tamaño original.

         aArray := { 1 }           // Resultado: aArray es { 1 }
         ASIZE( aArray, 3)         // Resultado: aArray es { 1, NIL, NIL }
         ASIZE( aArray, 1)         // Resultado: aArray es { 1 }
Status

Ready

Compliance

Si HB_COMPAT_C53 es definido, la función genera un Error, de otro modo retornará el mismo array.

Files

El código fuente está en arrays.c La librería asociada es vm

See Also