INSERT IN ARRAY

4D v16.3

INSERT IN ARRAY


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

Parámetro	Tipo	Descripción
array	Array	Nombre del array
posicion	Entero largo	Donde insertar los elementos
reemplazos	Entero largo	Nú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