XOOPS Brasil

 

math

Nome do atributo Tipo Obrigatório Padrão Descrição
equation string Sim n/a a equação à ser executar
format string Não n/a o formato do resultado (sprintf)
var numérico Sim n/a valor da variável da equação
assign string Não n/a variável de template cuja saída será atribuida
[var ...] numérica Sim n/a valor da variável da equação

math permite o desenhista de template fazer equações matemáticas no template. Qualquer variável de template numérica pode ser usada nas equações, e o resultado é exibido no lugar da tag. As variáveis usadas na equação são passadas como parâmetros, que podem ser variáveis de template ou valores estáticos. +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans and tan são todos os operadores válidos. Verifique a documentação do PHP para mais informações acerca destas funções matemáticas.

Se você fornece o atributo especial "assign", a saída da função matemática será atribuído para esta variável de template ao invés de ser exibida para o template.

Nota Técnica

math é uma função de performance cara devido ao uso da função do php eval(). Fazendo a matemática no PHP é muito mais eficiente, então sempre é possível fazer os cálculos matemáticos no PHP e lançar os resultados para o template. Definitivamente evite chamadas de funções de matemáticas repetitivamente, como dentro de loops de section.

Example 8.14. math


{* $height=4, $width=5 *}

{math equation="x + y" x=$height y=$width}

MOSTRA:

9


{* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *}

{math equation="height * width / division"
      height=$row_height
      width=$row_width
      division=#col_div#}

MOSTRA:

100


{* Você pode usar parenteses *}

{math equation="(( x + y ) / z )" x=2 y=10 z=2}

MOSTRA:

6


{* você pode fornecer um parâmetro de formato em sprintf *}

{math equation="x + y" x=4.4444 y=5.0000 format="%.2f"}

MOSTRA:

9.44