collection.remove( )

4D v19.8


collection.remove ( positionDépart {; combien} ) -> Résultat

Paramètre	Type	Description
positionDépart	Entier long	Elément de départ de la suppression
combien	Entier long	Nombre d'éléments à supprimer (1 élément si omis)
Résultat	Collection	Collection d'origine moins le(s) élément(s) supprimé(s)

Description

La méthode collection.remove( ) supprime un ou plusieurs élément(s) dans la collection à partir de la position spécifiée par positionDépart et retourne la collection modifiée.

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

Dans positionDépart, passez le numéro de l'élément à partir duquel la suppression doit débuter dans la collection. Attention : N'oubliez pas que les éléments des collections sont numérotés à partie de 0. Si positionDépart est supérieur à la longueur de la collection, le numéro de départ sera celui de la longueur (collection.length) de la collection.

Si positionDépart < 0, le paramètre est recalculé comme positionDépart:=positionDépart+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, positionDépart prend la valeur 0.
Si valeur recalculée > longueur de la collection, positionDépart prend comme valeur longueur de la collection .

Dans combien, passez le nombre d'éléments à supprimer à partir de positionDépart. Si combien n'est pas spécifié, un seul élément est supprimé.

Si vous tentez de supprimer un élément d'une collection vide, la méthode ne fait rien (aucune erreur n'est générée).

Exemple

 C_COLLECTION($col)

 $col:=New collection("a";"b";"c";"d";"e";"f";"g";"h")

 $col.remove(3) // $col=["a","b","c","e","f","g","h"]

 $col.remove(3;2) // $col=["a","b","c","g","h"]

 $col.remove(-8;1) // $col=["b","c","g","h"]

 $col.remove(-3;1) // $col=["b","g","h"]

Voir aussi

collection.clear( )