INSERT IN ARRAY
INSERT IN ARRAY ( array ; posicion {; reemplazos} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| array | Array | → | Nombre del array |
| posicion | Integer | → | Donde insertar los elementos |
| reemplazos | Integer | → | 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}:=...