INSERT IN ARRAY

INSERT IN ARRAY ( array ; onde {; quantos} )

Parâmetro	Tipo		Descrição
array	Array	→	Nome do array
onde	Integer	→	Onde inserir os elementos
quantos	Integer	→	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}:=...

Ver também

DELETE FROM ARRAY
Size of array

Propriedades

Número do comando	227
Thread-seguro	✓