smarty/docs/it/designers/language-custom-functions/language-function-math.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
		<sect1 id="language.function.math">
			<title>math</title>
            <informaltable frame="all">
                <tgroup cols="5">
                <colspec colname="param" align="center" />
                <colspec colname="type" align="center" />
                <colspec colname="required" align="center" />
                <colspec colname="default" align="center" />
                <colspec colname="desc" />
                <thead>
                    <row>
                        <entry>Nome Attributo</entry>
                        <entry>Tipo</entry>
                        <entry>Obbligatorio</entry>
                        <entry>Default</entry>
                        <entry>Descrizione</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>equation</entry>
                        <entry>stringa</entry>
                        <entry>s<EFBFBD></entry>
                        <entry><emphasis>nessuno</emphasis></entry>
                        <entry>l'equazione da eseguire</entry>
                    </row>
                    <row>
                        <entry>format</entry>
                        <entry>stringa</entry>
                        <entry>no</entry>
                        <entry><emphasis>nessuno</emphasis></entry>
                        <entry>formato del risultato (sprintf)</entry>
                    </row>
                    <row>
                        <entry>var</entry>
                        <entry>numerico</entry>
                        <entry>s<EFBFBD></entry>
                        <entry><emphasis>nessuno</emphasis></entry>
                        <entry>valore di una variabile dell'equazione</entry>
                    </row>
                    <row>
                        <entry>assign</entry>
                        <entry>stringa</entry>
                        <entry>no</entry>
                        <entry><emphasis>nessuno</emphasis></entry>
                        <entry>variabile del template cui verr<72> assegnato il risultato</entry>
                    </row>
                    <row>
                        <entry>[var ...]</entry>
                        <entry>numerico</entry>
                        <entry>s<EFBFBD></entry>
                        <entry><emphasis>nessuno</emphasis></entry>
                        <entry>valore di una variabile dell'equazione</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
	    La funzione math permette al progettista di effettuare equazioni
	    matematiche nel template. Qualsiasi variabile numerica del template
	    pu<70> essere utilizzata nell'equazione; il risultato verr<72> stampato
	    al posto del tag. Le variabili usate nell'equazione vengono passate
	    come parametri, che possono essere variabili del template o valori
	    statici. +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, 
            min, pi, pow, rand, round, sin, sqrt, srans e tan sono tutti operatori
            validi. Controllate la documentazione di PHP per ulteriori informazioni
            su queste funzioni matematiche.
			</para>
			<para>
			Se fornite lo speciale attributo "assign", l'output della
			funzione verr<72> assegnato a questa variabile del template, 
			invece di essere stampato in output.
			</para>
			<note>
				<title>Nota tecnica</title>
				<para>
				math <20> una funzione costosa in termini di prestazioni, a
				causa dell'uso che fa della funzione php eval(). Fare i
				calcoli matematici in PHP <20> molto pi<70> efficiente, quindi,
				quando possibile, fate i calcoli in PHP ed assegnate i
				risultati al template. Evitate decisamente chiamate
				ripetitive alla funzione math, ad esempio in cicli section.
            	</para>
			</note>
<example>
<title>math</title>
<programlisting>
{* $height=4, $width=5 *}

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

OUTPUT:

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#}

OUTPUT:

100


{* potete usare le parentesi *}

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

OUTPUT:

6


{* potete indicare un parametro format in formato sprintf *}

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

OUTPUT:

9.44</programlisting>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->