AINS()

Inserta un elemento NIL en una posición del array

Syntax

AINS( <aArray>, <nPos> ) --> aDestino

Arguments

<aArray> es el nombre del array al que se va a insertar un item

<nPos> es la posición en el <aArray>

Returns

AINS() retorna una referencia al array destino, <aDestino>

Description

Esta función inserta un valor NIL en el array llamado <aArray> en la posicion <nPos>.

Todos los elementos del array comenzando con la <nPos> serán desplazados hacia arriba una posición y el último item en el array será removido completamente. En otras palabras, si se va a insertar un item en la quinta posición de un array de diez elementos, el elemento que previamente estaba en la quinta posición ahora será reubicado a la sexta posición. El elemento recién agregado será de tipo NIL y el último elemento es descartado. La longitud del array <aArray> permanece sin cambios.
Examples
      *  El siguiente ejemplo crea un array lineal, al cual se inserta un
         elemento en la quinta posición, perdiéndose el último.

         LOCAL aArray:= { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
         AINS( aArray, 5)

         Resultado: aArray es { 1, 2, 3, 4, NIL, 5, 6, 7, 8, 9 }
Status

Ready

Compliance

Esta función es totalmente compatible con CA-Clipper.

Files

El código fuente está en arrays.c La librería asociada es vm

See Also