formula.apply( )

4D v19

formula.apply( )

Descrição

O método formula.apply( ) executa o objeto fórmula ao que se aplica e devolve o valor resultante. O objeto fórmula pode ser criado utilizando os comandos Formula ou Formula from string.

No parâmetro objThis, pode passar uma referência ao objeto que será utilizado como This dentro da fórmula.

Também pode passar uma coleção para usar como parâmetros $1...$n na fórmula utilizando o parâmetro opcional paramsFormula.

Lembre que formula.apply( ) é similar a VP EXPORT DOCUMENT exceto que os parâmetros são passados como uma coleção. Isto pode ser útil para passar resultados calculados.

Exemplo 1

 $f:=New formula($1+$2+$3)

 

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

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

Exemplo 2

 C_OBJECT($calc;$feta;$robot)

 $robot:=New object("name";"Robot";"price";543;"quantity";2)

 $feta:=New object("name";"Feta";"price";12.5;"quantity";5)

 

 $calc:=New formula(This.total:=This.price*This.quantity)

 

 $calc.apply($feta) // $feta={name:Feta,price:12.5,quantity:5,total:62.5}

 $calc.apply($robot) // $robot={name:Robot,price:543,quantity:2,total:1086}

Ver também

formula.call( )