collection.insert( )

4D v19.8


collection.insert ( position ; élément ) -> Résultat

Paramètre	Type	Description
position	Entier long	Où insérer l'élément
élément	Expression	Elément à insérer dans la collection
Résultat	Collection	Collection d'origine incluant l'élément inséré

Description

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:=Creer 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( )