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