switch.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<sect1 xml:id="control-structures.switch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>switch</title>
 <?phpdoc print-version-for="switch"?>
 <simpara>
  L'instruction <literal>switch</literal> équivaut à une série d'instructions
  <literal>if</literal>. En de nombreuses occasions, vous aurez besoin de
  comparer la même variable (ou expression) avec un grand nombre de valeurs
  différentes, et d'exécuter différentes parties de code suivant la valeur
  à laquelle elle est égale. C'est exactement à cela que sert l'instruction
  <literal>switch</literal>.
 </simpara>
 <note>
  <simpara>
   Notez que contrairement à d'autres langages, la structure
   <link linkend="control-structures.continue">continue</link> s'applique
   aux structures <literal>switch</literal> et se comporte de la même manière
   que <literal>break</literal>.
   Si vous avez un <literal>switch</literal> dans une boucle, et que vous
   souhaitez continuer jusqu'à la prochaine itération de la boucle extérieure,
   vous devez utiliser <literal>continue 2</literal>.
  </simpara>
 </note>
 <note>
  <para>
   Notez que switch/case provoque une
   <link linkend="types.comparisions-loose">comparaison large</link>.
  </para>
 </note>

 <para>
  Dans l'exemple suivant, chaque bloc de code est équivalent.
  L'un utilise une série d'instructions <literal>if</literal> et
  <literal>elseif</literal>, et l'autre une instruction de type
  <literal>switch</literal>. Dans chaque cas, la sortie est la même.
  <example>
   <title>Instruction <literal>switch</literal></title>
   <programlisting role="php">
<![CDATA[
<?php
// Ce switch:

switch ($i) {
    case 0:
        echo "i égal 0";
        break;
    case 1:
        echo "i égal 1";
        break;
    case 2:
        echo "i égal 2";
        break;
}

// Équivaut à:

if ($i == 0) {
    echo "i égal 0";
} elseif ($i == 1) {
    echo "i égal 1";
} elseif ($i == 2) {
    echo "i égal 2";
}
?>
]]>
   </programlisting>
  </example>
 </para>
 <para>
  Il est important de comprendre que l'instruction
  <literal>switch</literal> exécute chacune des
  clauses dans l'ordre. L'instruction <literal>switch</literal>
  est exécutée ligne par ligne. Au début,
  aucun code n'est exécuté. Uniquement lorsqu'une instruction 
  <literal>case</literal> est trouvée dont 
  l'expression est évaluée à une valeur qui correspond à la valeur de 
  l'expression <literal>switch</literal>, PHP exécute alors les instructions correspondantes.
  PHP continu d'exécuter les instructions jusqu'à
  la fin du bloc d'instructions du <literal>switch</literal>,
  ou bien dès qu'il trouve l'instruction <literal>break</literal>.
  Si vous ne pouvez pas utiliser l'instruction
  <literal>break</literal> à la fin de l'instruction
  <literal>case</literal>, PHP continuera à exécuter
  toutes les instructions qui suivent. Par exemple :
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
switch ($i) {
    case 0:
        echo "i égal 0";
    case 1:
        echo "i égal 1";
    case 2:
        echo "i égal 2";
}
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <simpara>
  Dans cet exemple, si <varname>$i</varname> est égal à 0, PHP va
  exécuter quand même toutes les instructions qui
  suivent! Si <varname>$i</varname> est égal à 1, PHP exécutera
  les deux dernières instructions. Et seulement si <varname>$i</varname> est
  égal à 2, vous obtiendrez le résultat
  escompté, c'est-à-dire, l'affichage de
  "i égal 2". Donc, l'important est de ne pas oublier
  l'instruction <literal>break</literal> (même s'il est
  possible que vous l'omettiez dans certaines circonstances).
 </simpara>
 <simpara>
  Dans une commande <literal>switch</literal>, une condition n'est
  évaluée qu'une fois, et le résultat est
  comparé à chaque <literal>case</literal>.
  Dans une structure <literal>elseif</literal>, les conditions sont
  évaluées à chaque comparaison. Si votre
  condition est plus compliquée qu'une simple
  comparaison, ou bien fait partie d'une boucle,
  <literal>switch</literal> sera plus rapide.
 </simpara>
 <para>
  La liste de commandes d'un <literal>case</literal> peut
  être vide, auquel cas PHP utilisera la liste de
  commandes du cas suivant.
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
switch ($i) {
    case 0:
    case 1:
    case 2:
        echo "i est plus petit que 3 mais n'est pas négatif";
        break;
    case 3:
        echo "i égal 3";
}
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <para>
  Un cas spécial est <literal>default</literal>. Ce cas est utilisé lorsque tous
  les autres cas ont échoué. Par exemple :
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
switch ($i) {
    case 0:
        echo "i égal 0";
        break;
    case 1:
        echo "i égal 1";
        break;
    case 2:
        echo "i égal 2";
        break;
    default:
       echo "i n'est ni égal à 2, ni à 1, ni à 0.";
}
?>
]]>
   </programlisting>
  </informalexample>
  <note>
   <simpara>
    Plusieurs cas default lèveront une erreur de niveau
    <constant>E_COMPILE_ERROR</constant>.
   </simpara>
  </note>
  <note>
   <simpara>
    Techniquement, le cas <literal>default</literal> peut être placé
    à n'importe quelle position. Il ne sera utilisé que si aucun autre cas ne correspond.
    Cependant, par convention, il est préférable de le placer à la fin.
   </simpara>
  </note>
 </para>
 <para>
  Si aucun <literal>case</literal> ne correspond, et qu'il n'y a pas de <literal>default</literal>, alors aucun code ne sera exécuté, tout comme si aucune instruction <literal>if</literal> n'était vraie.
 </para>
<para>
    Une valeur de <literal>case</literal> peut être donnée sous forme d'expression. Cependant, cette expression sera
  évaluée seule, puis comparée de manière approximative à la valeur du <literal>switch</literal>. Cela signifie
  qu'elle ne peut pas être utilisée pour des évaluations complexes de la valeur du <literal>switch</literal>. Par exemple :
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$target = 1;
$start = 3;

switch ($target) {
    case $start - 1:
        print "A";
        break;
    case $start - 2:
        print "B";
        break;
    case $start - 3:
        print "C";
        break;
    case $start - 4:
        print "D";
        break;
}

// Prints "B"
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <para>
  Pour des comparaisons plus complexes, la valeur &true; peut être utilisée comme valeur de <literal>switch</literal>.
  Ou, alternativement, des blocs <literal>if</literal>-<literal>else</literal> au lieu de <literal>switch</literal>.
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$offset = 1;
$start = 3;

switch (true) {
    case $start - $offset === 1:
        print "A";
        break;
    case $start - $offset === 2:
        print "B";
        break;
    case $start - $offset === 3:
        print "C";
        break;
    case $start - $offset === 4:
        print "D";
        break;
}

// Prints "B"
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <para>
  La syntaxe alternative pour cette structure de contrôle est
  la suivante : (pour plus d'informations, voir
  <link linkend="control-structures.alternative-syntax">syntaxes
  alternatives</link>).
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
switch ($i):
    case 0:
        echo "i égal 0";
        break;
    case 1:
        echo "i égal 1";
        break;
    case 2:
        echo "i égal 2";
        break;
    default:
        echo "i n'est ni égal à 2, ni à 1, ni à 0";
endswitch;
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <para>
  Il est possible d'utiliser un point-virgule plutôt que deux points après
  un case, comme ceci :
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
switch($beer)
{
    case 'leffe';
    case 'grimbergen';
    case 'guinness';
        echo 'Bon choix';
        break;
    default;
        echo 'Merci de faire un choix...';
        break;
}
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 
  <sect2 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member>&match;</member>
   </simplelist>
  </para>
 </sect2>
</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:"~/.phpdoc/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
-->