archived-doc-fr/language/types/boolean.xml

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

<sect1 xml:id="language.types.boolean">
 <title>Booléen</title>

 <simpara>
  Le type <type>bool</type> ne possède que deux valeurs, et est utilisé pour
  exprimer une valeur de vérité. Il peut être soit &true; soit &false;.
 </simpara>

 <sect2 xml:id="language.types.boolean.syntax">
  <title>Syntaxe</title>
  <para>
   Pour spécifier un &boolean; littéral, utiliser la constante &true; ou
   &false;. Les deux sont insensibles à la casse.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$foo = true; // assigne la valeur TRUE à $foo
?>
]]>
   </programlisting>
  </informalexample>

  <para>
   Typiquement, le résultat d'un <link linkend="language.operators">opérateur</link>
   qui retourne un &boolean;, passé ensuite à une
   <link linkend="language.control-structures">structure de contrôle</link>.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$action = "show_version";
$show_separators = true;

// == est un opérateur qui teste
// l'égalité et retourne un booléen
if ($action == "show_version") {
    echo "La version est 1.23";
}

// ceci n'est pas nécessaire...
if ($show_separators == TRUE) {
    echo "<hr>\n";
}

// ...à la place, vous pouvez utiliser, avec la même signification :
if ($show_separators) {
    echo "<hr>\n";
}
?>
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="language.types.boolean.casting">
  <title>Conversion en booléen</title>

  <simpara>
  Pour convertir explicitement une valeur en <type>bool</type>, utiliser
  le cast <literal>(bool)</literal>. Généralement, cela n'est pas nécessaire
  car lorsqu'une valeur est utilisée dans un contexte logique, elle sera
  automatiquement interprétée comme une valeur de type <type>bool</type>.
  Pour plus d'informations, voir la page
  <link linkend="language.types.type-juggling">Type Juggling</link>.
  </simpara>

  <para>
   Lors d'une conversion en &boolean;, les valeurs suivantes sont
   considérées comme &false; :
  </para>
  
  <itemizedlist>
   <listitem>
    <simpara>
     le <link linkend="language.types.boolean">booléen</link> &false;, lui-même
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     l'<link linkend="language.types.integer">entier</link> 
     <literal>0</literal> (zéro)
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     les <link linkend="language.types.float">nombres à virgule flottante</link>
     <literal>0.0</literal> et <literal>-0.0</literal> (zéro)
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     la <link linkend="language.types.string">chaîne</link> vide <literal>""</literal>,
     et la <link linkend="language.types.string">chaîne</link> <literal>"0"</literal>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     un <link linkend="language.types.array">tableau</link> avec aucun élément
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     le type unité <link linkend="language.types.null">NULL</link> (incluant
     les variables non définies)
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     les objets internes qui surchargent leur comportement de casting en booléen.
     Par exemple : les <link linkend="ref.simplexml">objets SimpleXML</link> créés à
     partir d'éléments vides sans attributs.
    </simpara>
   </listitem>
  </itemizedlist>

  <para>
   Toutes les autres valeurs sont considérées comme &true; (y compris les
   <link linkend="language.types.resource">ressources</link> et <constant>NAN</constant>).
  </para>

  <warning>
   <simpara>
    <literal>-1</literal> est considéré comme &true;, comme tous les nombres
    différents de zéro (négatifs ou positifs) !
   </simpara>
  </warning>

  <example>
   <title>Conversion en booléen</title>
   <programlisting role="php">
<![CDATA[
<?php
var_dump((bool) "");        // bool(false)
var_dump((bool) "0");       // bool(false)
var_dump((bool) 1);         // bool(true)
var_dump((bool) -2);        // bool(true)
var_dump((bool) "foo");     // bool(true)
var_dump((bool) 2.3e5);     // bool(true)
var_dump((bool) array(12)); // bool(true)
var_dump((bool) array());   // bool(false)
var_dump((bool) "false");   // bool(true)
?>
]]>
   </programlisting>
  </example>

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