collection.slice( )

4D v19.8

collection.slice( )


collection.slice ( positionDépart {; fin} ) -> Résultat

Paramètre	Type	Description
positionDépart	Entier long	Numéro de l'élément de départ (inclus)
fin	Entier long	Numéro de l'élément de fin (non inclus)
Résultat	Collection	New collection containing sliced elements (shallow copy)

Description

La méthode collection.slice( ) retourne une nouvelle collection obtenue en découpant la collection d'origine depuis l'élément numéro positionDépart jusqu'au numéro d'élément fin (fin non inclus). Cette méthode retourne une copie superficielle (shallow copy) de la collection.
Si la collection d'origine est une collection partagée, la collection retournée est aussi une collection partagée.

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

La collection retournée contient l'élément défini par positionDépart et tous les éléments suivants jusqu'à, mais sans inclure, l'élément défini par fin. Si seul le paramètre positionDépart est défini, la collection retournée contient tous les éléments depuis positionDépart jusqu'au dernier élément de la collection d'origine.

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 la valeur recalculée < 0, positionDépart prend la valeur 0.
Si fin < 0, le paramètre est recalculé comme fin :=fin +length
Si fin < positionDépart (valeurs passées ou recalculées), la méthode ne fait rien.

Exemple

 C_COLLECTION($c;$nc)

 $c:=New collection(1;2;3;4;5)

 $nc:=$c.slice(0;3) //$nc=[1,2,3]

 $nc:=$c.slice(3) //$nc=[4,5]

 $nc:=$c.slice(1;-1) //$nc=[2,3,4]

 $nc:=$c.slice(-3;-2) //$nc=[3]

Voir aussi

collection.extract( )