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 formula.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 Formula ou Formula from string.

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 formula.apply( ) et formule.call() sont similaires, sauf que les paramètres de formula.apply( ) sont passés sous forme de collection. Cela peut être utile pour passer des résultats de calculs.

Exemple 1

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

 

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

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

Exemple 2

 C_OBJECT($calc;$feta;$robot)

 $robot:=New object("nom";"Robot";"prix";543;"quantité";2)

 $feta:=New object("nom";"Feta";"prix";12.5;"quantité";5)

 

 $calc:=Formula(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()