Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com

Página Inicial

 
4D v19.8
collection.insert( )

collection.insert( ) 


 

collection.insert ( indice ; elemento ) -> Resultado 
Parâmetro Tipo   Descrição
indice  Inteiro longo in Onde inserir o elemento
elemento  Expression in Elemento a inserir na coleção
Resultado  Collection in Coleção original contendo elemento inserido

A função collection.insert( ) insere o elemento na posição de indice especificada na instância de coleção e devolve a coleção editada.

Nota: este comando modifica a coleção original.

Em indice, passe a posição onde deseja inserir o elemento na coleção.

Atenção: lembre que os elementos da coleção estão numerados desde 0.

  • Se indice > a longitude da coleção, o índice de inicio real se estabelecerá na longitude da coleção.
  • Se indice <0, volta a calcular como indice:=indice+longitude  (se considera como o deslocamento desde o final da coleção).
  • Se o valor calculado for negativo, indice se estabelece em 0.

Pode inserir qualquer tipo de elemento aceito por uma coleção, inclujsive outra coleção.

Exemplo  

 C_COLLECTION($col)
 $col:=New collection("a";"b";"c";"d") //$col=["a","b","c","d"]
 $col.insert(2;"X") //$col=["a","b","X","c","d"]
 $col.insert(-2;"Y") //$col=["a","b","X","Y","c","d"]
 $col.insert(-10;"Hi") //$col=["Hi","a","b","X","Y","c","d"]



Ver também 

collection.combine( )

 
PROPRIEDADES 

Produto: 4D
Tema: Coleções

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

Criado por: 4D v16 R6

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v19)
Manual de linguagem 4D ( 4D v19.1)
Manual de linguagem 4D ( 4D v19.4)
Manual de linguagem 4D ( 4D v19.5)
Manual de linguagem 4D ( 4D v19.6)
Manual de linguagem 4D ( 4D v19.7)
Manual de linguagem 4D ( 4D v19.8)