INSERT IN ARRAY
INSERT IN ARRAY ( array ; onde {; quantos} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| array | Array | 🡒 | Nome do array |
| onde | Inteiro longo | 🡒 | Onde inserir os elementos |
| quantos | Inteiro longo | 🡒 | Número de elementos a serem inseridos, ou 1 elemento se omitido |
Descrição
O comando INSERT IN ARRAY insere um ou mais elementos no array. Os novos elementos são inseridos antes do elemento especificado por onde, e são inicializados no valor vacio do tipo de array. Todos os elementos além de onde são movidos consequentemente no array por um valor de um ou pelo valor especificado em quantos.
Se onde é maior que o tamanho do array, os elementos são adicionados ao final do array.
O parâmetro quantos é o número de elementos a ser inserido. Se não for especificado quantos, então apenas um elemento é inserido. O tamanho do array aumenta em quantos.
Exemplo 1
O exemplo a seguir insere cinco novos elementos, começando no elemento 10:
INSERT IN ARRAY(anArray;10;5)
Exemplo 2
O exemplo a seguir adiciona um elemento a um array:
$vlElem:=Size of array(anArray)+1
INSERT IN ARRAY(anArray;$vlElem)
anArray{$vlElem}:=...