AINS	Top  Previous  Next

Sintaxis:

AINS( <aMatriz>, <nPosicion> ) -> aMatriz

Argumentos:

<aMatriz> es la matriz en la que se insertará el nuevo elemento.

<nPosicion> es la posición en la que se insertará el nuevo elemento.

Devuelve:

aMatriz.

Categorías:

Matrices.

   AINS() inserta un elemento en la posición especificada. El valor de este nuevo elemento es NIL y todos los que estén a la derecha de nPosicion se desplazan. El último valor de la matriz se pierde. Hay que tener cuidado si el último elemento de la matriz es otra matriz ya que en este caso se perderán todos los elementos de esta matriz. Se puede utilizar AADD() o ASIZE() para añadir o aumentar el tamaño de la matriz y luego usar AINS() para insertar el valor.


Ejemplo:

   aMatriz := { "a", "b", "c" }
   AINS( aMatriz, 2 )
   // aMatriz es { "a", NIL, "b" }