Saltar al contenido principal
Versión: 20 R7 BETA

INSERT IN ARRAY

INSERT IN ARRAY ( array ; posicion {; reemplazos} )

ParámetroTipoDescripción
arrayArrayNombre del array
posicionIntegerDonde insertar los elementos
reemplazosIntegerNúmero de elementos a insertar, o 1 elemento si se omite

Descripción

El comando INSERT IN ARRAY inserta uno o más elementos en el array. Los nuevos elementos se insertan antes del elemento especificado por donde, y se inicializan en el valor vacío del tipo de array. Todos los elementos más allá de donde se mueven consecuentemente en el array por un valor de uno o por el valor especificado en cuantos.

Si donde es mayor que el tamaño del array, los elementos se añaden al final del array.

El parámetro cuantos es el número de elementos a insertar. Si no se especifica cuantos, entonces se inserta sólo un elemento. El tamaño del array aumenta en cuantos.

Ejemplo 1

El siguiente ejemplo inserta cinco nuevos elementos, comenzando en el elemento 10:

 INSERT IN ARRAY(anArray;10;5)

Ejemplo 2

El siguiente ejemplo añade un elemento a un array:

 $vlElem:=Size of array(anArray)+1
 INSERT IN ARRAY(anArray;$vlElem)
 anArray{$vlElem}:=...

Ver también

DELETE FROM ARRAY
Size of array

Propiedades

Número de comando227
Hilo seguro