ASIZE()

Sintaxis

ASIZE( <array>, <expresión numérica> )

Propósito

Modifica el tamaño de un array existente, aumentándolo o disminuyéndolo.

Argumentos

< array >

Define el nombre del array cuyo tamaño se modificará.

< expresión numérica >

Define el nuevo tamaño del array.

Utilización

La función ASIZE() modifica el tamaño del array especificado. El array se aumentará o disminuirá para alcanzar el tamaño especificado por la expresión numérica.

Si se disminuye el array, se descartarán los últimos elementos. Si se aumenta el array, los nuevos elementos se agregarán al final y contendrán el valor NIL.

Sugerencias

La función ASIZE() es similar a la función AADD(), que agrega únicamente un elemento al final de un array y, opcionalmente, puede atribuir un valor al nuevo elemento. Las funciones ASIZE() y AADD() modifican el  tamaño de un array y, por este motivo, difieren significativamente de las funciones AINS() y ADEL(), que lo mantienen constante.

Ejemplos

Estos ejemplos muestran la adición de nuevos elementos y la eliminación de los elementos existentes:

LOCAL aArray := { 1 }       // Resulta: { 1 }.

ASIZE(aArray, 3)               // Resulta: { 1, NIL, NIL }.

ASIZE(aArray, 1)               // Resulta: { 1 }.