4D v14.3

INSERT IN ARRAY

Página Inicial

 
4D v14.3
INSERT IN ARRAY

INSERT IN ARRAY 


 

INSERT IN ARRAY ( array ; onde {; quantos} ) 
Parâmetro Tipo   Descrição
array  Array in Nome do array
onde  Inteiro longo in Onde inserir os elementos
quantos  Inteiro longo in Número de elementos a serem inseridos, ou 1 elemento se omitido

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.

O exemplo a seguir insere cinco novos elementos, começando no elemento 10:

 INSERT IN ARRAY(anArray;10;5)

O exemplo a seguir adiciona um elemento a um array:

 $vlElem:=Size of array(anArray)+1
 INSERT IN ARRAY(anArray;$vlElem)
 anArray{$vlElem}:=...

 
PROPRIEDADES 

Produto: 4D
Tema: Arrays
Número 227

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

DELETE FROM ARRAY
Size of array

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)