formule.apply()

4D v19.8

formule.apply()


formule.apply() ({ thisObj {; formuleParams}} ) -> Résultat

Paramètre	Type	Description
thisObj	Objet	Objet à retourner via la commande "This" appelée dans la formule
formuleParams	Collection	Collection de valeurs à passer en $1...$n lorsque la formule est exécutée
Résultat	Varié	Valeur résultant de la formule exécutée

Description

La méthode formule.apply() exécute l'objet formule auquel elle est appliquée et retourne la valeur résultante. L'objet formule peut être créé à l'aide des commandes Formule ou Formule sur chaine.

Dans le paramètre thisObj, vous pouvez passer une référence vers l'objet et la retourner en This dans la formule.

Vous pouvez également passer une collection à utiliser en paramètres $1...$n dans la formule à l'aide du paramètre optionnel formuleParams.

Notez que formule.apply() et formule.call() sont similaires, sauf que les paramètres de formule.apply() sont passés sous forme de collection. Cela peut être utile pour passer des résultats de calculs.

Exemple 1

 $f:=Formule($1+$2+$3)

 

 $c:=Creer collection(10;20;30)

 $result:=$f.apply(Null;$c) // retourne 60

Exemple 2

 C_OBJET($calc;$feta;$robot)

 $robot:=Creer objet("nom";"Robot";"prix";543;"quantité";2)

 $feta:=Creer objet("nom";"Feta";"prix";12.5;"quantité";5)

 

 $calc:=Formule(This.total:=This.prix*This.quantité)

 

 $calc.apply($feta) // $feta={nom:Feta,prix:12.5,quantité:5,total:62.5}

 $calc.apply($robot) // $robot={nom:Robot,prix:543,quantité:2,total:1086}

Voir aussi

formule.call()