Files
smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml
2006-09-30 15:12:18 +00:00

257 lines
6.2 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready -->
<sect1 id="language.function.if">
<title>{if},{elseif},{else}</title>
<para>
L'instruction <varname>{if}</varname> dans Smarty dispose de la même flexibilité que l'instruction
PHP <ulink url="&url.php-manual;if">if</ulink>,
avec quelques fonctionnalités supplémentaires pour le
moteur de template. Tous les <varname>{if}</varname> doivent être
utilisés de pair avec un <varname>{/if}</varname>.
<varname>{else}</varname> et <varname>{elseif}</varname> sont également
des balises autorisées. Toutes les conditions et fonctions PHP sont reconnues,
comme <emphasis>||</emphasis>, <emphasis>or</emphasis>,
<emphasis>&amp;&amp;</emphasis>, <emphasis>and</emphasis>,
<emphasis>is_array()</emphasis>, etc.
</para>
<para>
Si <link linkend="variable.security"><parameter>$security</parameter></link> est actif,
alors le tableau <emphasis>IF_FUNCS</emphasis> dans le tableau
<link linkend="variable.security.settings"><parameter>$security_settings</parameter></link> (?!).
</para>
<para>
La liste suivante présente les opérateurs reconnus, qui doivent être entourés d'espaces.
Remarquez que les éléments listés entre [crochets] sont optionnels. Les équivalents
PHP sont indiqués lorsque applicables.
</para>
<informaltable frame="all">
<tgroup cols="4">
<colspec colname="qualifier" align="center" />
<colspec colname="alternates" align="center" />
<colspec colname="meaning" />
<colspec colname="example" />
<colspec colname="php" />
<thead>
<row>
<entry>Opérateur</entry>
<entry>Syntaxe alternative</entry>
<entry>Exemple de syntaxe</entry>
<entry>Signification</entry>
<entry>Equivalent PHP</entry>
</row>
</thead>
<tbody>
<row>
<entry>==</entry>
<entry>eq</entry>
<entry>$a eq $b</entry>
<entry>égalité</entry>
<entry>==</entry>
</row>
<row>
<entry>!=</entry>
<entry>ne, neq</entry>
<entry>$a neq $b</entry>
<entry>différence</entry>
<entry>!=</entry>
</row>
<row>
<entry>&gt;</entry>
<entry>gt</entry>
<entry>$a gt $b</entry>
<entry>supérieur à</entry>
<entry>&gt;</entry>
</row>
<row>
<entry>&lt;</entry>
<entry>lt</entry>
<entry>$a lt $b</entry>
<entry>inférieur à</entry>
<entry>&lt;</entry>
</row>
<row>
<entry>&gt;=</entry>
<entry>gte, ge</entry>
<entry>$a ge $b</entry>
<entry>supérieur ou égal à</entry>
<entry>&gt;=</entry>
</row>
<row>
<entry>&lt;=</entry>
<entry>lte, le</entry>
<entry>$a le $b</entry>
<entry>inférieur ou égal à</entry>
<entry>&lt;=</entry>
</row>
<row>
<entry>===</entry>
<entry></entry>
<entry>$a === 0</entry>
<entry>égalité (type et valeur)</entry>
<entry>===</entry>
</row>
<row>
<entry>!</entry>
<entry>not</entry>
<entry>not $a</entry>
<entry>négation</entry>
<entry>!</entry>
</row>
<row>
<entry>%</entry>
<entry>mod</entry>
<entry>$a mod $b</entry>
<entry>modulo</entry>
<entry>%</entry>
</row>
<row>
<entry>is [not] div by</entry>
<entry></entry>
<entry>$a is not div by 4</entry>
<entry>divisible par</entry>
<entry>$a % $b == 0</entry>
</row>
<row>
<entry>is [not] even</entry>
<entry></entry>
<entry>$a is not even</entry>
<entry>est [ou non] un nombre pair</entry>
<entry>$a % 2 == 0</entry>
</row>
<row>
<entry>is [not] even by</entry>
<entry></entry>
<entry>$a is not even by $b</entry>
<entry>paritée de groupe</entry>
<entry>($a / $b) % 2 == 0</entry>
</row>
<row>
<entry>is [not] odd</entry>
<entry></entry>
<entry>$a is not odd</entry>
<entry>est [ou non] un nombre impair</entry>
<entry>$a % 2 != 0</entry>
</row>
<row>
<entry>is [not] odd by</entry>
<entry></entry>
<entry>$a is not odd by $b</entry>
<entry>est [ou non] un groupe impair</entry>
<entry>($a / $b) % 2 != 0</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<example>
<title>Instruction {if}</title>
<programlisting>
<![CDATA[
{if $name eq 'Fred'}
Bienvenue, Monsieur.
{elseif $name eq 'Wilma'}
Bienvenue m'dame.
{else}
Bienvenue, qui que vous soyez.
{/if}
{* Un exemple avec l'opérateur or *}
{if $name eq 'Fred' or $name eq 'Wilma'}
...
{/if}
{* même chose que ci-dessus *}
{if $name == 'Fred' || $name == 'Wilma'}
...
{/if}
{* les parenthèses sont autorisées *}
{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#}
...
{/if}
{* vous pouvez également faire appel aux fonctions PHP *}
{if count($var) gt 0}
...
{/if}
{* Vérifie si c'est un tableau. *}
{if is_array($foo) }
.....
{/if}
{* Vérifie si la variable est nulle. *}
{if isset($foo) }
.....
{/if}
{* teste si les valeurs sont paires(even) ou impaires(odd) *}
{if $var is even}
...
{/if}
{if $var is odd}
...
{/if}
{if $var is not odd}
...
{/if}
{* teste si la variable est divisible par 4 *}
{if $var is div by 4}
...
{/if}
{* teste si la variable est paire, par groupe de deux i.e.,
0=paire, 1=paire, 2=impaire, 3=impaire, 4=paire, 5=paire, etc. *}
{if $var is even by 2}
...
{/if}
{* 0=paire, 1=paire, 2=paire, 3=impaire, 4=impaire, 5=impaire, etc. *}
{if $var is even by 3}
...
{/if}
]]>
</programlisting>
</example>
<example>
<title>Plus d'exemples avec {if}</title>
<programlisting>
<![CDATA[
{if isset($name) && $name = 'Blog'}
{* faire quelque chose *}
{elseif $name == $foo}
{* faire quelque chose *}
{/if}
{if is_array($foo) && count($foo) > 0)
{* faire une boucle foreach *}
{/if}
]]>
</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
-->