ASIZE ( )

 Amplía o reduce una matriz

Sintaxis

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

 Argumentos

     <aDestino> matriz que se va a ampliar o reducir.

     <nLongitud> es el nuevo tamaño de la matriz.

 Devuelve

ASIZE() devuelve una referencia a la matriz destino, <aDestino>.

 Descripción

ASIZE() es una función de tratamiento de matrices que cambia la longitud real de la matriz <aDestino>. La matriz se acorta o se alarga hasta que coincida con la longitud especificada. Si la matriz se acorta, los elementos que se encuentren al final de la misma se pierden. Si la matriz se alarga, se añaden nuevos elementos al final de la matriz y se les asigna el valor NIL.

ASIZE() es similar a AADD(), que añade un nuevo elemento al final de una matriz y, si se desea, le asigna un nuevo valor. Recuerde que ASIZE() es diferente a AINS() y ADEL(), que no cambian realmente la longitud de la matriz.

 Ejemplos

     ¦  Los ejemplos siguientes muestran la adición de nuevos

        elementos y el borrado de elementos existentes:

        aMatriz := { 1 }       //Resultado: aMatriz es { 1 }

        ASIZE(aMatriz, 3)      //Resultado: aMatriz es { 1, NIL, NIL }

        ASIZE(aMatriz, 1)      //Resultado: aMatriz es { 1 }

 Ficheros: La biblioteca asociada es DPXBASE.CH.