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.

      Nota: ASIZE() sólo admite matrices unidimensionales.

 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 CLIPPER.LIB.

 To download this example - click here.

See Also: AADD() ADEL() AFILL() AINS()