<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: fee54c7c435a1664a7a8b0e7b7de7cec4a084c45 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, ou les objets

<classname>GMP</classname> représentant la valeur

<literal>0</literal>.

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

-->