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 DPXBASE 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 DPXBASE.CH.