collection.insert( )

4D v19.8


collection.insert ( indice ; elemento ) -> Resultado

Parâmetro	Tipo	Descrição
indice	Inteiro longo	Onde inserir o elemento
elemento	Expression	Elemento a inserir na coleção
Resultado	Collection	Coleção original contendo elemento inserido

Descrição

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( )