collection.fill( )

4D v19.8

collection.fill( )


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

Paramètre	Type	Description
valeur	Numérique, Texte, Collection, Objet, Date, Booléen	Valeur de remplissage
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	Collection d'origine avec valeurs de remplissage

Description

La méthode collection.fill( ) remplit les éléments de la collection avec valeur, optionnellement depuis l'élément positionDépart et jusqu'à l'élément fin (non inclus), et retourne la collection résultante.

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

Si positionDépart est omis, la valeur est appliquée à tous les éléments de la collection (positionDépart=0). Si le paramètre fin est omis, la valeur est appliquée jusqu'au dernier élément (fin=length).
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)

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

 $c.fill("2") // $c:=[2,2,2,2,2,2,2,2]

 $c.fill("Hello";5) // $c=[2,2,2,2,2,Hello,Hello,Hello]

 $c.fill(0;1;5) // $c=[2,0,0,0,0,Hello,Hello,Hello]

 $c.fill("world";1;-5) //-5+8=3 -> $c=[2,"world","world",0,0,Hello,Hello,Hello]

Voir aussi

collection.resize( )