collection.combine( )

4D v19.8


collection.combine ( col2 {; position} ) -> Résultat

Paramètre	Type	Description
col2	Collection	Collection to combine
position	Entier long	Où insérer les éléments à combiner (défaut=length+1)
Résultat	Collection	Collection d'origine incluant les éléments combinés

Description

La méthode collection.combine( ) insère les éléments de col2 à la fin ou à la position de la collection et retourne la collection modifiée. A la différence de la méthode collection.insert( ), collection.combine( ) ajoute chaque valeur de col2 dans la collection d'origine, et non en tant qu'élément unique de collection.

Note : Cette méthode modifie la collection d'origine.

Par défaut, les éléments de col2 sont ajoutés à la fin de la collection d'origine. Vous pouvez passer dans position le numéro de l'élément après lequel vous souhaitez que les éléments de col2 soient insérés dans la collection. Attention : N'oubliez pas que les éléments des collections sont numérotés à partir de 0.

Si position > longueur de la collection, position sera la longueur (collection.length) de la collection.
Si position < 0, le paramètre est recalculé comme position:=position+length (la fin de la collection est considérée comme point de départ du calcul de la position).
Si valeur recalculée < 0, position prend la valeur 0.

Exemple

 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]

Voir aussi

collection.concat( )
collection.insert( )