4D v19

collection.combine( )

Accueil

 
4D v19
collection.combine( )

collection.combine( )  


 

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

 
PROPRIÉTÉS 

Produit : 4D
Thème : Collections

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
PAGE CONTENTS 
 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v19)
4D - Langage ( 4D v19.1)