4D v18

collection.insert( )

Accueil

 
4D v18
collection.insert( )

collection.insert( )  


 

La méthode collection.insert( ) insère élément dans la collection à la position spécifiée par position et retourne la collection modifiée.

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

Dans position, passez le numéro de l'élément après lequel vous souhaitez que élément soit inséré.

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.

Vous pouvez passer tout type d'élément accepté par les collections dans élément, y compris une autre collection.

Exemple  

 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"]



Voir aussi  

collection.combine( )

 
PROPRIÉTÉS 

Produit : 4D
Thème : Collections

 
PAGE CONTENTS 
 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v18)