4D Doc Center : INSERT IN ARRAY

4D v14.3

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}:=...