smarty/docs/fr/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>Nom attribut</entry>
                        <entry>Type</entry>
                        <entry>Requis</entry>
                        <entry>Defaut</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>equation</entry>
                        <entry>cha<EFBFBD>ne de caract<63>res</entry>
                        <entry>Oui</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>L'op<6F>ration <20> <20>x<EFBFBD>cuter</entry>
                    </row>
                    <row>
                        <entry>format</entry>
                        <entry>cha<EFBFBD>ne de caract<63>res</entry>
                        <entry>Non</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>Le format du r<>sultat (sprintf)</entry>
                    </row>
                    <row>
                        <entry>var</entry>
                        <entry>numeric</entry>
                        <entry>Oui</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>Les variables de l'op<6F>ration</entry>
                    </row>
                    <row>
                        <entry>assign</entry>
                        <entry>cha<EFBFBD>ne de caract<63>res</entry>
                        <entry>Non</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>Variable de template dans laquelle la sortie
                        sera assign<67>e</entry>
                    </row>
                    <row>
                        <entry>[var ...]</entry>
                        <entry>numeric</entry>
                        <entry>Oui</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>Valeurs des variables de l'op<6F>ration</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
            math autorise les designers de templates <20> effectuer des op<6F>rations
            dans le template. Toute valeur num<75>rique peut <20>tre utilis<69>e dans une
            op<6F>ration, et le r<>sultat sera affich<63> <20> la place des balises
            "equation". Les variables utilis<69>es dans l'op<6F>ration sont pass<73>es en
            tant que param<61>tre, et peuvent <20>tre des variables de templates ou des
            valeurs statiques. +, -, /, *, abs, ceil, cos,
            exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt,
            srans et tan sont tous des op<6F>rateurs valides. Voir la
            documentation PHP pour plus d'informations sur ces fonctions
            math<74>matiques.
			</para>
			<para>
			Si vous sp<73>cifiez l'attribut assign, la sortie sera assign<67>e <20> la variable
			donn<6E>e plut<75>t que d'<27>tre directement affich<63>e.
			</para>
			<note>
				<title>Note technique</title>
				<para>
            math est une fonction co<63>teuse en terme de performances, du fait
            qu'elle utilise la fonction PHP eval (). Effectuer les calculs
            dans votre code PHP est beaucoup plus efficient, donc, chaque fois
            que possible, effectuez vos calculs directement dans PHP et assignez
            le r<>sultat au template. Evitez co<63>t que co<63>t les appels
            r<>p<EFBFBD>titifs <20> la fonction math, comme on pourait le faire une
            une boucle section.
            	</para>
			</note>
<example>
<title>math</title>
<programlisting>
{* $height=4, $width=5 *}

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

SORTIE:

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

SORTIE:

100


{* vous pouvez utiliser des parenth<74>ses *}

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

SORTIE:

6


{* vous pouvez d<>finir un format sprintf pour l'affichage *}

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

SORTIE:

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