4D v19

collection.insert( )

Página Inicial

 
4D v19
collection.insert( )

collection.insert( )  


 

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 

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v19)
Manual de linguagem 4D ( 4D v19.1)