collection.map( )

4D v19.8

collection.map( )


collection.map ( nomMéthode {; param}{; param2 ; ... ; paramN} ) -> Résultat

Paramètre	Type	Description
nomMéthode	Texte	Nom de la méthode à appeler pour transformer les éléments de la collection
param	Expression	Paramètre(s) à passer à nomMéthode
Résultat	Collection	Collection de valeurs transformées

Description

La méthode collection.map( ) crée une nouvelle collection basée sur le résultat de l'exécution de la méthode nomMéthode sur chaque élément de la collection d'origine. Optionnellement, vous pouvez passer des paramètres à nomMéthode via le paramètre param. collection.map( ) retourne toujours une collection de taille égale à celle de la collection d'origine.

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

nomMéthode reçoit les paramètres suivants :

dans $1.value (tout type) : valeur de l'élément à évaluer
dans $2 (tout type) : param
dans $N... (tout type) : param2...paramN

nomMéthode doit fixer le(s) paramètre(s) suivant(s) :

$1.result (tout type) : nouvelle valeur transformée à ajouter à la collection résultante.
$1.stop (booléen, optionnel) : true pour stopper le rétroappel de méthode. La valeur retournée est la dernière calculée.

Exemple

 C_COLLECTION($c;$c2)

 $c:=Creer collection(1;4;9;10;20)

 $c2:=$c.map("Percentage";$c.sum())

  //$c2=[2.27,9.09,20.45,22.73,45.45]

Voici la méthode Percentage :

 C_OBJET($1)

 C_REEL($2)

 $1.result:=Arrondi(($1.value/$2)*100;2)

Voir aussi

collection.extract( )