AINS()
 Inserta un elemento NIL en una matriz
------------------------------------------------------------------------------
 Sintaxis

     AINS(<aDestino>, <nPosición>) --> aDestino

 Argumentos

     <aDestino> es la matriz en la que se va a insertar el nuevo
     elemento.

     <nPosición> es la posición en la que se va a insertar el nuevo
     elemento.

 Devuelve

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

 Descripción

     AINS() es una función de matrices que inserta un nuevo elemento en una
     matriz especificada. El elemento recién insertado será de tipo NIL
     hasta que se le asigne un nuevo valor. Después de la inserción, el
     último elemento de la matriz se descarta y todos los elementos que van
     detrás del elemento nuevo se desplazan una posición.

     ¡Advertencia! AINS() debe utilizarse con cuidado en matrices
     multidimensionales. En CA-Clipper las matrices multidimensionales se
     crean anidando unas matrices dentro de otras. La utilización de AINS()
     en una matriz multidimensional elimina el último elemento de la matriz
     y, si dicho elemento es una submatriz, se pierden una o más
     dimensiones. Para insertar una nueva dimensión en una matriz, añada
     primero un nuevo elemento al final de la matriz mediante AADD() o
     ASIZE() antes de utilizar AINS().

 Ejemplos

      El ejemplo siguiente muestra el resultado de la utilización de
        AINS() en una matriz:

        LOCAL aMatriz
        aMatriz := { 1, 2, 3 }       // Resultado: aMatriz es
                                     // ahora { 1, 2, 3 }
        AINS(aMatriz, 2)             // Resultado: aMatriz es
                                     // ahora { 1, NIL, 2 }

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: AADD() ACOPY() ADEL() AEVAL() AFILL() ASIZE()