collection.combine( )

4D v19.8


collection.combine ( col2 {; index} ) -> Resultado

Parâmetro	Tipo	Descrição
col2	Collection	coleção a combinar
index	Inteiro longo	posição onde inserir elementos a combinar na coleção (normal = lenght +1)
Resultado	Collection	Coleção original que contém os elementos combinados

Descrição

O método collection.combine( ) insere elementos col2 ao final ou na posição index especificada na instância de coleção e devolve a coleção editada. Diferente do método collection.insert( ), collection.combine( ) agrega cada valor de col2 na coleção original e não como um único elemento de coleção.

Nota: este método modifica a coleção original.

Como padrão os elementos col2 se agregam ao final da coleção original. Pode passar em index a posição onde deseja inserir os elementos de col2 na coleção. Advertência: lembre que os elementos da coleção estão numerados desde 0.

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

Exemplo

 C_COLLECTION($c;$fruits)

 $c:=New collection(1;2;3;4;5;6)

 $fruits:=New collection("Orange";"Banana";"Apple";"Grape")

 $c.combine($fruits;3) //[1,2,3,"Orange","Banana","Apple","Grape",4,5,6]

Ver também

collection.concat( )
collection.insert( )