AADD()
 Añade un nuevo elemento al final de una matriz
------------------------------------------------------------------------------
 Sintaxis

     AADD(<aDestino >, <expValor>) --> Valor

 Argumentos

     <aDestino> es la matriz a la que se va a añadir un nuevo elemento.

     <expValor> es el valor que se va a asignar al nuevo elemento.

 Devuelve

     AADD() evalúa <expValor> y devuelve su valor. Si no se especifica
     <expValor>, AADD() devuelve NIL.

 Descripción

     AADD() es una función de tratamiento de matrices que aumenta en uno la
     longitud real de la matriz destino. Al elemento recién creado se le
     asigna el valor especificado por <expValor>.

     AADD() se utiliza para ampliar dinámicamente una matriz. Resulta útil
     para crear listas o colas dinámicas. Un buen ejemplo de esto es la
     matriz GetList, que utiliza el sistema Get para almacenar objetos Get.
     Después de ejecutar READ o CLEAR GETS, GetList pasa a ser una matriz
     vacía. Cada vez que se ejecuta un mandato @...GET, el sistema Get
     utiliza AADD() para añadir un elemento nuevo al final de la matriz
     GetList y, a continuación, asigna un nuevo objeto Get al nuevo
     elemento.

     AADD() es similar a ASIZE(), excepto en que añade los elementos de uno
     en uno. ASIZE(), en cambio, puede ampliar o reducir una matriz
     directamente a un tamaño especificado. AADD() tiene la ventaja de que
     permite asignar un valor al nuevo elemento, mientras que ASIZE() no lo
     permite. AADD() también puede parecer similar a AINS(), pero se
     diferencian en que AINS() desplaza elementos dentro de una matriz, pero
     no cambia la longitud de la misma.

     Nota: Si <expValor> es otra matriz, el nuevo elemento de la matriz
     destino contendrá una referencia a la matriz especificada por
     <expValor>.

 Ejemplos

      Los ejemplos siguientes muestran los resultados de llamadas
        múltiples a AADD() con una matriz:

        aMatriz := {}                // Resultado: aMatriz es una matriz vacía
        AADD(aMatriz, 5)             // Resultado: aMatriz es { 5 }
        AADD(aMatriz, 10)            // Resultado: aMatriz es { 5, 10 }
        AADD(aMatriz,{12,10})        // Resultado: aMatriz es
                                     // { 5, 10, { 12, 10 } }

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: AINS() ASIZE()