formula.apply( )

4D v19.8

formula.apply( )


formula.apply ({ thisObj {; formulaParams}} ) -> Resultado

Parâmetro	Tipo	Descrição
thisObj	Objeto	Objeto a ser retornado pelo comando This na fórmula
formulaParams	Collection	Coleção dos valores a serem passados como $1...$n quando a fórmula for executada
Resultado	Mixed	Valor da execução da fórmula

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( )