cvs: phpdoc-fr /reference/var reference.xml /reference/var/functions doubleval.xml empty.xml get-defined-vars.xml get-resource-type.xml gettype.xml
is-array.xml is-bool.xml is-double.xml is-float.xml is-int.xml is-integer.xml is-long.xml is-null.xml is-numeric.xml is-object.xml is-real.xml
is-scalar.xml is-string.xml isset.xml print-r.xml serialize.xml settype.xml strval.xml unserialize.xml unset.xml var-dump.xml

From: Date: Sat, 26 Apr 2003 19:25:47 +0000
Subject: cvs: phpdoc-fr /reference/var reference.xml /reference/var/functions doubleval.xml empty.xml get-defined-vars.xml get-resource-type.xml gettype.xml
is-array.xml is-bool.xml is-double.xml is-float.xml is-int.xml is-integer.xml is-long.xml is-null.xml is-numeric.xml is-object.xml is-real.xml
is-scalar.xml is-string.xml isset.xml print-r.xml serialize.xml settype.xml strval.xml unserialize.xml unset.xml var-dump.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-304@lists.php.net to get a copy of this message
dams Sat Apr 26 15:25:47 2003 EDT Modified files: /phpdoc-fr/reference/var reference.xml /phpdoc-fr/reference/var/functions doubleval.xml empty.xml get-defined-vars.xml get-resource-type.xml gettype.xml is-array.xml is-bool.xml is-double.xml is-float.xml is-int.xml is-integer.xml is-long.xml is-null.xml is-numeric.xml is-object.xml is-real.xml is-scalar.xml is-string.xml isset.xml print-r.xml serialize.xml settype.xml strval.xml unserialize.xml unset.xml var-dump.xml Log: Spring cleaning

Index: phpdoc-fr/reference/var/reference.xml diff -u phpdoc-fr/reference/var/reference.xml:1.2 phpdoc-fr/reference/var/reference.xml:1.3 --- phpdoc-fr/reference/var/reference.xml:1.2 Mon Apr 15 20:55:19 2002 +++ phpdoc-fr/reference/var/reference.xml Sat Apr 26 15:25:45 2003 @@ -1,12 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> <reference id="ref.variables"> <title>Variables</title> - <titleabbrev>Fonctions sur les variables</titleabbrev> + <titleabbrev>Variables</titleabbrev> + + <partintro> + <section id="variables.intro"> + &reftitle.intro; + <para> + Pour plus de d&eacute;tails sur le comportement des variables, reportez vous + &agrave; la section <link linkend="language.variables">Variables</link> + du chapitre <link linkend="langref">R&eacute;f&eacute;rence du langage</link>. + </para> + </section> + + <section id="variables.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section id="variables.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.var.ini; + + <section id="variables.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="variables.constants"> + &reftitle.constants; + &no.constants; + </section> + + </partintro> &reference.var.functions; - </reference> -<!-- Keep this comment at the end of the file + </reference><!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t Index: phpdoc-fr/reference/var/functions/doubleval.xml diff -u phpdoc-fr/reference/var/functions/doubleval.xml:1.1 phpdoc-fr/reference/var/functions/doubleval.xml:1.2 --- phpdoc-fr/reference/var/functions/doubleval.xml:1.1 Sun Apr 14 20:39:38 2002 +++ phpdoc-fr/reference/var/functions/doubleval.xml Sat Apr 26 15:25:46 2003 @@ -5,39 +5,24 @@ <refnamediv> <refname>doubleval</refname> <refpurpose> - Retourne la valeur num&eacute;rique (double) de la variable. + Alias de <function>floatval</function> </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - - <type>double</type><methodname>doubleval</methodname> - <methodparam><type>mixed</type><parameter>var</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>doubleval</function> retourne la valeur num&eacute;rique - (double) de la variable <parameter>var</parameter>. - </simpara> <para> - <parameter>var</parameter> peut &ecirc;tre de type scalaire. Vous ne - pouvez pas utiliser la fonction <function>doubleval</function> avec - un tableau ou un objet. - <informalexample> - <programlisting role="php"> -&lt;?php -$var = '122.34343Le'; -$double_valeur_de_var = doubleval($var); -print $double_valeur_de_var; // affiche 122.34343 -?&gt; - </programlisting> - </informalexample> + <function>doubleval</function> est un &alias; de + <function>floatval</function>. </para> - <simpara> - Voir aussi <function>intval</function>, <function>strval</function>, - <function>settype</function> et - <link linkend="language.types.type-juggling">Transtypage</link>. - </simpara> + <note> + <para> + Cet alias est un reste de la vague de renommage de fonctions. + Dans les anciennes versions de &php;, vous aurez besoin d'utiliser + cette fonction, qui est un alias de <function>floatval</function>, + car <function>floatval</function> n'&eacute;tait pas disponible &agrave; + cette &eacute;poque. + </para> + </note> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/empty.xml diff -u phpdoc-fr/reference/var/functions/empty.xml:1.2 phpdoc-fr/reference/var/functions/empty.xml:1.3 --- phpdoc-fr/reference/var/functions/empty.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/var/functions/empty.xml Sat Apr 26 15:25:46 2003 @@ -4,30 +4,36 @@ <refentry id="function.empty"> <refnamediv> <refname>empty</refname> - <refpurpose>D&eacute;termine si une variable est affect&eacute;e.</refpurpose> + <refpurpose>D&eacute;termine si une variable contient une valeur non nulle</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - - <type>int</type><methodname>empty</methodname> - <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <type>bool</type><methodname>empty</methodname> + <methodparam><type>mixed</type><parameter>var</parameter></methodparam> </methodsynopsis> + <note> + <para> + <function>empty</function> est une structure de langage. + </para> + </note> <para> <function>empty</function> retourne la valeur &false; si la variable <parameter>var</parameter> est affect&eacute;e ou bien a une valeur diff&eacute;rente de 0; la valeur &true; dans les autres cas. <informalexample> <programlisting role="php"> -&lt;?php -$var = 0; -if (empty($var)) { // retourne &true; - print 'soit $var vaut 0, soit il n'est pas d&eacute;fini'; -} -if (!isset($var)) { // retourne <literal>FALSE</literal> - print '$var n'est pas d&eacute;finie'; -} -?&gt; +<![CDATA[ +<?php + $var = 0; + if (empty($var)) { // retourne &true; + print 'soit $var vaut 0, soit il n\'est pas d&eacute;fini'; + } + if (!isset($var)) { // retourne &false; + print '$var n'est pas d&eacute;finie'; + } +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/var/functions/get-defined-vars.xml diff -u phpdoc-fr/reference/var/functions/get-defined-vars.xml:1.1 phpdoc-fr/reference/var/functions/get-defined-vars.xml:1.2 --- phpdoc-fr/reference/var/functions/get-defined-vars.xml:1.1 Sun Apr 14 20:39:38 2002 +++ phpdoc-fr/reference/var/functions/get-defined-vars.xml Sat Apr 26 15:25:46 2003 @@ -4,15 +4,13 @@ <refentry id="function.get-defined-vars"> <refnamediv> <refname>get_defined_vars</refname> - <refpurpose> - Liste toutes les variables d&eacute;finies - </refpurpose> + <refpurpose>Liste toutes les variables d&eacute;finies</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>get_defined_vars</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <void/> </methodsynopsis> <para> <function>get_defined_vars</function> retourne un tableau multidimensionnel @@ -20,26 +18,36 @@ des variables d'environnement, de serveurs ou d&eacute;finies par l'utilisateur. <informalexample> <programlisting role="php"> -&lt;?php -$b = array(1,1,2,3,5,8); -$arr = get_defined_vars(); + <![CDATA[ +<?php + $b = array(1,1,2,3,5,8); + + $arr = get_defined_vars(); + // affiche $b -print_r($arr["b"]); + print_r($arr["b"]); + // affiche le chemin jusqu'&agrave; l'interpr&eacute;teur CGI PHP (si PHP est utilis&eacute; en CGI) // i.e. /usr/local/bin/php -echo $arr["_"]; + echo $arr["_"]; + // affiche la ligne de commande, s'il y en a une -print_r($arr["argv"]); + print_r($arr["argv"]); + // affiche toutes les variables serveurs -print_r($arr["HTTP_SERVER_VARS"]); + print_r($arr["HTTP_SERVER_VARS"]); + // affiche toutes les cl&eacute;s disponibles dans les tableaux de variables -print_r(array_keys(get_defined_vars())); -?&gt; + print_r(array_keys(get_defined_vars())); +?> +]]> </programlisting> </informalexample> </para> <para> - Voir aussi <function>get_defined_functions</function>. + Voir aussi + <function>get_defined_functions</function> et + <function>get_defined_constants</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/get-resource-type.xml diff -u phpdoc-fr/reference/var/functions/get-resource-type.xml:1.1 phpdoc-fr/reference/var/functions/get-resource-type.xml:1.2 --- phpdoc-fr/reference/var/functions/get-resource-type.xml:1.1 Sun Apr 14 20:39:38 2002 +++ phpdoc-fr/reference/var/functions/get-resource-type.xml Sat Apr 26 15:25:46 2003 @@ -18,20 +18,22 @@ n'est pas une ressource valide, une erreur est g&eacute;n&eacute;r&eacute;e. <informalexample> <programlisting role="php"> -&lt;?php -$c = mysql_connect(); -echo get_resource_type($c)."\n"; +<![CDATA[ +<?php + $c = mysql_connect(); + echo get_resource_type($c)."\n"; // affiche : mysql link // (lien mysql) -$fp = fopen("foo","w"); -echo get_resource_type($fp)."\n"; + $fp = fopen("foo","w"); + echo get_resource_type($fp)."\n"; // affiche : file // (fichier) -$doc = new_xmldoc("1.0"); -echo get_resource_type($doc->doc)."\n"; + $doc = new_xmldoc("1.0"); + echo get_resource_type($doc->doc)."\n"; // affiche : domxml document // (document domxml) -?&gt; +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/var/functions/gettype.xml diff -u phpdoc-fr/reference/var/functions/gettype.xml:1.1 phpdoc-fr/reference/var/functions/gettype.xml:1.2 --- phpdoc-fr/reference/var/functions/gettype.xml:1.1 Sun Apr 14 20:39:39 2002 +++ phpdoc-fr/reference/var/functions/gettype.xml Sat Apr 26 15:25:46 2003 @@ -4,7 +4,7 @@ <refentry id="function.gettype"> <refnamediv> <refname>gettype</refname> - <refpurpose>Retourne le type de la variable.</refpurpose> + <refpurpose>Retourne le type de la variable</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -17,43 +17,74 @@ <function>gettype</function> retourne le type de la variable PHP <parameter>var</parameter>. </para> + <warning> + <simpara> + N'utilisez jamais <function>gettype</function> pour v&eacute;rifier un type, + car la cha&icirc;ne retourn&eacute;e est sujette &agrave; modification sans pr&eacute;avis dans + une version ult&eacute;rieure. De plus, c'est bien plus long comme cela, + car cela implique une comparaison de cha&icirc;ne. + </simpara> + <simpara> + A la place, utilisez les fonctions <literal>is_*</literal>. + </simpara> + </warning> <para> Les cha&icirc;nes de caract&egrave;res que peut retourner la fonction sont les suivantes : <itemizedlist> <listitem> - <simpara>"boolean"</simpara> + <simpara>"<type>boolean</type>" (depuis PHP 4)</simpara> </listitem> <listitem> - <simpara>"integer"</simpara> + <simpara>"<type>integer</type>"</simpara> </listitem> <listitem> - <simpara>"double"</simpara> + <simpara>"<type>double</type>" (pour des raisons historiques, + "double" est retourn&eacute;e lorsqu'une valeur de type <type>float</type> + est fournie, au lieu de la cha&icirc;ne "float")</simpara> </listitem> <listitem> - <simpara>"string"</simpara> + <simpara>"<type>string</type>"</simpara> </listitem> <listitem> - <simpara>"array"</simpara> + <simpara>"<type>array</type>"</simpara> </listitem> <listitem> - <simpara>"object"</simpara> + <simpara>"<type>object</type>"</simpara> </listitem> <listitem> - <simpara>"resource"</simpara> + <simpara>"<type>resource</type>" (depuis PHP 4)</simpara> </listitem> <listitem> - <simpara>"user function"</simpara> + <simpara>"<type>NULL</type>" (depuis PHP 4)</simpara> </listitem> <listitem> - <simpara>"unknown type"</simpara> + <simpara>"user function" (PHP 3 uniquement, abandonn&eacute;)</simpara> + </listitem> + <listitem> + <simpara>"unknown type"<!-- someone's joking? --></simpara> </listitem> </itemizedlist> </para> <para> - Voir aussi <function>settype</function>. + En &php; 4, il est recommand&eacute; d'utiliser <function>function_exists</function> et + <function>method_exists</function> pour remplacer l'utilisation de + <function>gettype</function> sur une fonction. </para> - </refsect1> + <para> + Voir aussi + <function>settype</function>, + <function>is_array</function>, + <function>is_bool</function>, + <function>is_float</function>, + <function>is_integer</function>, + <function>is_null</function>, + <function>is_numeric</function>, + <function>is_object</function>, + <function>is_resource</function>, + <function>is_scalar</function> et + <function>is_string</function>. + </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Index: phpdoc-fr/reference/var/functions/is-array.xml diff -u phpdoc-fr/reference/var/functions/is-array.xml:1.1 phpdoc-fr/reference/var/functions/is-array.xml:1.2 --- phpdoc-fr/reference/var/functions/is-array.xml:1.1 Sun Apr 14 20:39:39 2002 +++ phpdoc-fr/reference/var/functions/is-array.xml Sat Apr 26 15:25:46 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-array"> <refnamediv> <refname>is_array</refname> - <refpurpose>D&eacute;termine si une variable est un tableau.</refpurpose> + <refpurpose>D&eacute;termine si une variable est un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,17 +14,15 @@ </methodsynopsis> <para> <function>is_array</function> renvoie la valeur &true; - si la variable <parameter>var</parameter> est un tableau, + si la variable <parameter>var</parameter> est un <type>array</type>, &false; sinon. </para> <para> - Voir aussi <function>is_double</function>, + Voir aussi <function>is_float</function>, <function>is_int</function>, <function>is_integer</function>, - <function>is_real</function>, - <function>is_string</function>, - <function>is_long</function>, et + <function>is_string</function> et <function>is_object</function>. </para> </refsect1> Index: phpdoc-fr/reference/var/functions/is-bool.xml diff -u phpdoc-fr/reference/var/functions/is-bool.xml:1.1 phpdoc-fr/reference/var/functions/is-bool.xml:1.2 --- phpdoc-fr/reference/var/functions/is-bool.xml:1.1 Sun Apr 14 20:39:39 2002 +++ phpdoc-fr/reference/var/functions/is-bool.xml Sat Apr 26 15:25:46 2003 @@ -5,7 +5,7 @@ <refnamediv> <refname>is_bool</refname> <refpurpose> - D&eacute;termine si une variable est un tableau bool&eacute;en + D&eacute;termine si une variable est un bool&eacute;en </refpurpose> </refnamediv> <refsect1> @@ -16,17 +16,38 @@ </methodsynopsis> <para> <function>is_bool</function> retourne &true; si <parameter>var</parameter> - est un bool&eacute;en. + est un <type>boolean</type>. </para> <para> - Voir aussi <function>is_array</function>, - <function>is_double</function>, + <example> + <title>Exemple avec <function>is_bool</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = false; +$b = 0; + +// Comme $a est un bool&eacute;en, ceci est vrai +if (is_bool($a)) { + print "Oui, c'est un bool&eacute;en"; +} + +// Comme $b n'est pas un bool&eacute;en, ceci est faux +if (is_bool($b)) { + print "Oui, c'est un bool&eacute;en"; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>is_array</function>, <function>is_float</function>, <function>is_int</function>, <function>is_integer</function>, - <function>is_real</function>, - <function>is_string</function>, - <function>is_long</function>, et + <function>is_string</function> et <function>is_object</function>. </para> </refsect1> Index: phpdoc-fr/reference/var/functions/is-double.xml diff -u phpdoc-fr/reference/var/functions/is-double.xml:1.1 phpdoc-fr/reference/var/functions/is-double.xml:1.2 --- phpdoc-fr/reference/var/functions/is-double.xml:1.1 Sun Apr 14 20:39:39 2002 +++ phpdoc-fr/reference/var/functions/is-double.xml Sat Apr 26 15:25:46 2003 @@ -4,29 +4,13 @@ <refentry id="function.is-double"> <refnamediv> <refname>is_double</refname> - <refpurpose>D&eacute;termine si une variable est de type double.</refpurpose> + <refpurpose>Alias de <function>is_float</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>is_double</methodname> - <methodparam><type>mixed</type><parameter>var</parameter></methodparam> - </methodsynopsis> <para> - <function>is_double</function> renvoie &true; si - la variable <parameter>var</parameter> est du type "double", - &false; sinon. - </para> - <para> - Voir aussi <function>is_array</function>, - <function>is_bool</function>, - <function>is_float</function>, - <function>is_int</function>, - <function>is_integer</function>, - <function>is_real</function>, - <function>is_string</function>, - <function>is_long</function>, et - <function>is_object</function>. + <function>is_double</function> est un &alias; de + <function>is_float</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/is-float.xml diff -u phpdoc-fr/reference/var/functions/is-float.xml:1.1 phpdoc-fr/reference/var/functions/is-float.xml:1.2 --- phpdoc-fr/reference/var/functions/is-float.xml:1.1 Sun Apr 14 20:39:39 2002 +++ phpdoc-fr/reference/var/functions/is-float.xml Sat Apr 26 15:25:46 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-float"> <refnamediv> <refname>is_float</refname> - <refpurpose>D&eacute;termine si une variable est de type float.</refpurpose> + <refpurpose>D&eacute;termine si une variable est de type float</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/var/functions/is-int.xml diff -u phpdoc-fr/reference/var/functions/is-int.xml:1.1 phpdoc-fr/reference/var/functions/is-int.xml:1.2 --- phpdoc-fr/reference/var/functions/is-int.xml:1.1 Sun Apr 14 20:39:39 2002 +++ phpdoc-fr/reference/var/functions/is-int.xml Sat Apr 26 15:25:46 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-int"> <refnamediv> <refname>is_int</refname> - <refpurpose>D&eacute;termine si une variable est de type integer.</refpurpose> + <refpurpose>D&eacute;termine si une variable est de type integer</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/var/functions/is-integer.xml diff -u phpdoc-fr/reference/var/functions/is-integer.xml:1.1 phpdoc-fr/reference/var/functions/is-integer.xml:1.2 --- phpdoc-fr/reference/var/functions/is-integer.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-integer.xml Sat Apr 26 15:25:46 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-integer"> <refnamediv> <refname>is_integer</refname> - <refpurpose>D&eacute;termine si une variable est de type int.</refpurpose> + <refpurpose>D&eacute;termine si une variable est de type int</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/var/functions/is-long.xml diff -u phpdoc-fr/reference/var/functions/is-long.xml:1.1 phpdoc-fr/reference/var/functions/is-long.xml:1.2 --- phpdoc-fr/reference/var/functions/is-long.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-long.xml Sat Apr 26 15:25:46 2003 @@ -4,29 +4,13 @@ <refentry id="function.is-long"> <refnamediv> <refname>is_long</refname> - <refpurpose>D&eacute;termine si une variable est de type integer.</refpurpose> + <refpurpose>Alias de <function>is_int</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>is_long</methodname> - <methodparam><type>mixed</type><parameter>var</parameter></methodparam> - </methodsynopsis> <para> - <function>is_long</function> renvoie &true; - si la variable <parameter>var</parameter> est du type - entier long (long), &false; sinon. - </para> - <para> - Voir aussi <function>is_bool</function>, - <function>is_double</function>, - <function>is_float</function>, - <function>is_int</function>, - <function>is_real</function>, - <function>is_string</function>, - <function>is_object</function>, - <function>is_array</function>, et - <function>is_integer</function>. + <function>is_long</function> est un &alias; de + <function>is_int</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/is-null.xml diff -u phpdoc-fr/reference/var/functions/is-null.xml:1.1 phpdoc-fr/reference/var/functions/is-null.xml:1.2 --- phpdoc-fr/reference/var/functions/is-null.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-null.xml Sat Apr 26 15:25:47 2003 @@ -5,7 +5,7 @@ <refnamediv> <refname>is_null</refname> <refpurpose> - Indique si une variable est &null; + Indique si une variable vaut &null; </refpurpose> </refnamediv> <refsect1> @@ -19,17 +19,22 @@ si <parameter>var</parameter> est &null;, et &false;. </para> <para> - Voir aussi : + Reportez-vous au type <link linkend="language.types.null.syntax">&null;</link> + pour savoir quand une variable est consid&eacute;r&eacute;e comme contenant la + valeur &null; ou non. + </para> + <para> + Voir aussi + <link linkend="language.types.null.syntax">&null;</link>, <function>is_bool</function>, - <function>is_double</function>, <function>is_numeric</function>, <function>is_float</function>, <function>is_int</function>, - <function>is_real</function>, <function>is_string</function>, <function>is_object</function>, - <function>is_array</function> et - <function>is_integer</function>. + <function>is_array</function>, + <function>is_integer</function> et + <function>is_real</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/is-numeric.xml diff -u phpdoc-fr/reference/var/functions/is-numeric.xml:1.1 phpdoc-fr/reference/var/functions/is-numeric.xml:1.2 --- phpdoc-fr/reference/var/functions/is-numeric.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-numeric.xml Sat Apr 26 15:25:47 2003 @@ -5,7 +5,7 @@ <refnamediv> <refname>is_numeric</refname> <refpurpose> - D&eacute;termine si une variable est un type num&eacute;rique + D&eacute;termine si une variable est un type num&eacute;rique </refpurpose> </refnamediv> <refsect1> @@ -20,14 +20,13 @@ num&eacute;rique, ou &false; sinon. </para> <para> - Voir aussi <function>is_bool</function>, - <function>is_double</function>, + Voir aussi + <function>is_bool</function>, <function>is_float</function>, <function>is_int</function>, - <function>is_real</function>, <function>is_string</function>, <function>is_object</function>, - <function>is_array</function>, et + <function>is_array</function> et <function>is_integer</function>. </para> </refsect1> Index: phpdoc-fr/reference/var/functions/is-object.xml diff -u phpdoc-fr/reference/var/functions/is-object.xml:1.1 phpdoc-fr/reference/var/functions/is-object.xml:1.2 --- phpdoc-fr/reference/var/functions/is-object.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-object.xml Sat Apr 26 15:25:47 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-object"> <refnamediv> <refname>is_object</refname> - <refpurpose>D&eacute;termine si une variable est de type object.</refpurpose> + <refpurpose>D&eacute;termine si une variable est de type object</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -19,13 +19,10 @@ </para> <para> Voir aussi <function>is_bool</function>, - <function>is_long</function>, <function>is_int</function>, <function>is_integer</function>, <function>is_float</function>, - <function>is_double</function>, - <function>is_real</function>, - <function>is_string</function>, et + <function>is_string</function> et <function>is_array</function>. </para> </refsect1> Index: phpdoc-fr/reference/var/functions/is-real.xml diff -u phpdoc-fr/reference/var/functions/is-real.xml:1.1 phpdoc-fr/reference/var/functions/is-real.xml:1.2 --- phpdoc-fr/reference/var/functions/is-real.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-real.xml Sat Apr 26 15:25:47 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-real"> <refnamediv> <refname>is_real</refname> - <refpurpose>D&eacute;termine si une variable est de type real.</refpurpose> + <refpurpose>D&eacute;termine si une variable est de type real</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/var/functions/is-scalar.xml diff -u phpdoc-fr/reference/var/functions/is-scalar.xml:1.1 phpdoc-fr/reference/var/functions/is-scalar.xml:1.2 --- phpdoc-fr/reference/var/functions/is-scalar.xml:1.1 Sun Apr 14 20:39:40 2002 +++ phpdoc-fr/reference/var/functions/is-scalar.xml Sat Apr 26 15:25:47 2003 @@ -21,11 +21,13 @@ </para> <para> Les variables scalaires sont celles qui contiennent des - entiers, des nombres &agrave; virgules flottantes, des cha&icirc;nes de + entiers, des nombres &agrave; virgule flottante, des cha&icirc;nes de caract&egrave;res ou des bool&eacute;ens. Par exemple : - <informalexample> + <example> + <title>Exemple avec <function>is_scalar</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php function show_var($var) { if (is_scalar($var)) echo $var; @@ -46,19 +48,14 @@ // [2]=> // string(10) "ferredoxine" // } -?&gt; +?> +]]> </programlisting> - </informalexample> + </example> </para> - <note> - <para> - <function>is_scalar</function> a &eacute;t&eacute; ajout&eacute;e en version PHP 4.05. - </para> - </note> <para> - Voir aussi : + Voir aussi <function>is_bool</function>, - <function>is_double</function>, <function>is_numeric</function>, <function>is_float</function>, <function>is_int</function>, Index: phpdoc-fr/reference/var/functions/is-string.xml diff -u phpdoc-fr/reference/var/functions/is-string.xml:1.1 phpdoc-fr/reference/var/functions/is-string.xml:1.2 --- phpdoc-fr/reference/var/functions/is-string.xml:1.1 Sun Apr 14 20:39:41 2002 +++ phpdoc-fr/reference/var/functions/is-string.xml Sat Apr 26 15:25:47 2003 @@ -4,7 +4,7 @@ <refentry id="function.is-string"> <refnamediv> <refname>is_string</refname> - <refpurpose>D&eacute;termine si une variable est de type string.</refpurpose> + <refpurpose>D&eacute;termine si une variable est de type string</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -18,13 +18,14 @@ de caract&egrave;res (string), &false; sinon. </para> <para> - Voir aussi <function>is_long</function>, + Voir aussi + <function>is_bool</function>, <function>is_int</function>, <function>is_integer</function>, <function>is_float</function>, - <function>is_double</function>, <function>is_real</function>, - <function>is_object</function>, et <function>is_array</function>. + <function>is_object</function> et + <function>is_array</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/isset.xml diff -u phpdoc-fr/reference/var/functions/isset.xml:1.2 phpdoc-fr/reference/var/functions/isset.xml:1.3 --- phpdoc-fr/reference/var/functions/isset.xml:1.2 Tue Aug 13 22:19:35 2002 +++ phpdoc-fr/reference/var/functions/isset.xml Sat Apr 26 15:25:47 2003 @@ -4,38 +4,95 @@ <refentry id="function.isset"> <refnamediv> <refname>isset</refname> - <refpurpose>D&eacute;termine si une variable est affect&eacute;e.</refpurpose> + <refpurpose>D&eacute;termine si une variable est affect&eacute;e</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>isset</methodname> + <type>bool</type><methodname>isset</methodname> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><parameter>...</parameter></methodparam> </methodsynopsis> + <note> + <para> + <function>isset</function> est une structure du langage. + </para> + </note> <simpara> <function>isset</function> renvoie &true; si la variable <parameter>var</parameter> est d&eacute;finie, &false; sinon. </simpara> <para> - Si une variable a &eacute;t&eacute; d&eacute;saffect&eacute;e avec la fonction + Si une variable a &eacute;t&eacute; d&eacute;truite avec la fonction <function>unset</function>, la fonction <function>isset</function> renverra - &false;. + &false;. <function>isset</function> reverra &false; lors du test d'une + variable de valeur &null;. Notez aussi que le caract&egrave;re nul + (<literal>"\0"</literal>) n'est pas &eacute;quivalent &agrave; la constante &php; + &null;. <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php + +$var = ''; + +// Ceci est vrai, alors le texte est affich&eacute; +if (isset($var)) { + print "Cette variable existe, donc je peux l'afficher."; +} + +// Dans les exemples suivants, nous utilisons var_dump() pour afficher +// le retour de la fonction isset(). + $a = "test"; -echo isset ($a); // &true; -unset($a); -echo isset ($a); // <literal>FALSE</literal> -?&gt; +$b = "anothertest"; + +var_dump( isset($a) ); // TRUE +var_dump( isset ($a, $b) ); // TRUE + +unset ($a); + +var_dump( isset ($a) ); // FALSE +var_dump( isset ($a, $b) ); // FALSE + +$foo = NULL; +var_dump( isset ($foo) ); // FALSE + +?> +]]> + </programlisting> + </informalexample> + </para> + <para> + Cela fonctionne aussi avec les tableaux : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + +$a = array ('test' => 1, 'bonjour' => NULL); + +var_dump( isset ($a['test']) ); // TRUE +var_dump( isset ($a['foo']) ); // FALSE +var_dump( isset ($a['bonjour']) ); // FALSE + +// La cl&eacute; 'bonjour' vaut NULL est est consid&eacute;r&eacute;e comme non existante +// Si vous voulez v&eacute;rifier l'existance de cette cl&eacute;e, utilisez cette fonction +var_dump( array_key_exists('bonjour', $a) ); // TRUE + +?> +]]> </programlisting> </informalexample> </para> <simpara> Voir aussi - <function>empty</function> et - <function>unset</function>. + <function>empty</function>, <function>unset</function> + <function>defined</function>, + <function>array_key_exists</function> et l'op&eacute;rateur de constr&ocirc;le + de rapport d'erreur <link linkend="language.operators.errorcontrol">@</link>. </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/print-r.xml diff -u phpdoc-fr/reference/var/functions/print-r.xml:1.1 phpdoc-fr/reference/var/functions/print-r.xml:1.2 --- phpdoc-fr/reference/var/functions/print-r.xml:1.1 Sun Apr 14 20:39:41 2002 +++ phpdoc-fr/reference/var/functions/print-r.xml Sat Apr 26 15:25:47 2003 @@ -11,11 +11,12 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>print_r</methodname> + <type>bool</type><methodname>print_r</methodname> <methodparam><type>mixed</type><parameter>expression</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return</parameter></methodparam> </methodsynopsis> <simpara> - Cette fonction affiche des informations &agrave; propos d'une + <function>print_r</function> affiche des informations &agrave; propos d'une variable, de mani&egrave;re &agrave; ce qu'elle soit lisible. Pour une cha&icirc;ne, un entier ou un double, la valeur sera elle m&ecirc;me sera affich&eacute;e. Pour les tableaux, @@ -24,18 +25,92 @@ disponible pour les objets. </simpara> <simpara> - Comparer <function>print_r</function> et <function>var_dump</function>. + Gardez en t&ecirc;te que <function>print_r</function> place le pointeur de + tableau &agrave; la fin du tableau. Utilisez <function>reset</function> pour + le ramener au d&eacute;but. </simpara> - <para> + &tip.ob-capture; + <para> <informalexample> <programlisting role="php"> -&lt;?php -$a = array (1, 2, array ("a", "b", "c")); -print_r ($a); -?&gt; +<![CDATA[ +<pre> +<?php + $a = array ('a' => 'pomme', 'b' => 'banane', 'c' => array ('x','y','z')); + print_r ($a); +?> +</pre> +]]> </programlisting> </informalexample> </para> + <para> + va afficher + <screen> +<![CDATA[ +<pre> +Array +( + [a] => pomme + [b] => banane + [c] => Array + ( + [0] => x + [1] => y + [2] => z + ) +) +</pre> +]]> + </screen> + </para> + <para> + Si vous voulez obtenir le r&eacute;sultat de <function>print_r</function> dans une cha&icirc;ne, + utilisez le param&egrave;tre <parameter>return</parameter>. Si ce param&egrave;tre vaut + &true;, <function>print_r</function> retournera ce qu'il aurait affich&eacute;. + </para> + <para> + <example> + <title>Utilisation du param&egrave;tre <parameter>return</parameter> de <function>print_r</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $b = array ('m' => 'mangue', 'foo' => 'bar', 'x' => array ('x', 'y', 'z')); + $resultat = print_r ($b, true); + //$resultat contient maintenant le r&eacute;sultat de print_r() +?> +]]> + </programlisting> + </example> + </para> + <note> + <simpara> + Si vous devez r&eacute;cup&eacute;rer le r&eacute;sultat de <function>print_r</function> avec une + version de &php; plus ancienne que 4.3.0, utilisez les fonctions de + <link linkend="ref.outcontrol">bufferisation de sortie</link>. + </simpara> + </note> + <note> + <simpara> + Le param&egrave;tre <parameter>return</parameter> a &eacute;t&eacute; ajout&eacute; en &php; 4.3.0. + </simpara> + </note> + <note> + <simpara> + Avant PHP 4.0.4, <function>print_r</function> bouclera &agrave; l'infini si + un <type>array</type> ou un <type>object</type> contient une r&eacute;f&eacute;rence + sur lui m&ecirc;me. Un exemple classique est notamment la ligne + <literal>print_r($GLOBALS)</literal> car + <literal>$GLOBALS</literal> est lui m&ecirc;me une variable globale, + qui donc, contient une r&eacute;f&eacute;rence sur elle m&ecirc;me. + </simpara> + </note> + <simpara> + Voir aussi + <function>ob_start</function>, + <function>var_dump</function> et + <function>var_export</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/serialize.xml diff -u phpdoc-fr/reference/var/functions/serialize.xml:1.1 phpdoc-fr/reference/var/functions/serialize.xml:1.2 --- phpdoc-fr/reference/var/functions/serialize.xml:1.1 Sun Apr 14 20:39:41 2002 +++ phpdoc-fr/reference/var/functions/serialize.xml Sat Apr 26 15:25:47 2003 @@ -29,14 +29,15 @@ <function>serialize</function> acceptent les types <type>integer</type>, <type>double</type>, <type>string</type>, <type>array</type> (multidimensionnels) et - <type>object</type> (les propri&eacute;t&eacute;s des objets seront lin&eacute;aris&eacute;es, mais - pas les m&eacute;thodes). + <type>object</type> (les propri&eacute;t&eacute;s des objets seront + lin&eacute;aris&eacute;es, mais pas les m&eacute;thodes). </simpara> <para> <example> <title>Exemple avec <function>serialize</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // $session_data contient un tableau multi-dimensionnel , avec les // informations de session de l'utilisateur courant. On utilise serialize() // pour les stocker dans une base de donn&eacute;es @@ -44,14 +45,15 @@ $stmt = odbc_prepare ($conn, "UPDATE sessions SET data = ? WHERE id = ?"); $sqldata = array (serialize($session_data), $PHP_AUTH_USER); -if (!odbc_execute ($stmt, &amp;$sqldata)) { +if (!odbc_execute ($stmt, &$sqldata)) { $stmt = odbc_prepare($conn, "INSERT INTO sessions (id, data) VALUES(?, ?)"); - if (!odbc_execute($stmt, &amp;$sqldata)) { + if (!odbc_execute($stmt, &$sqldata)) { /* Grosse bourde! Souffre et potasse! */ } } -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/var/functions/settype.xml diff -u phpdoc-fr/reference/var/functions/settype.xml:1.1 phpdoc-fr/reference/var/functions/settype.xml:1.2 --- phpdoc-fr/reference/var/functions/settype.xml:1.1 Sun Apr 14 20:39:41 2002 +++ phpdoc-fr/reference/var/functions/settype.xml Sat Apr 26 15:25:47 2003 @@ -4,36 +4,82 @@ <refentry id="function.settype"> <refnamediv> <refname>settype</refname> - <refpurpose>Affecte un type &agrave; une variable.</refpurpose> + <refpurpose>Affecte un type &agrave; une variable</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>settype</methodname> - <methodparam><type>string</type><parameter>var</parameter></methodparam> + <type>bool</type><methodname>settype</methodname> + <methodparam><type>mixed</type><parameter>var</parameter></methodparam> <methodparam><type>string</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> - <function>settype</function> modifie le type de la variable + <function>settype</function> force le type de la variable <parameter>var</parameter> en <parameter>type</parameter>. </para> <para> Les valeurs possibles pour le param&egrave;tre <parameter>type</parameter> sont : <itemizedlist> - <listitem><simpara>"integer"</simpara></listitem> - <listitem><simpara>"double"</simpara></listitem> - <listitem><simpara>"string"</simpara></listitem> - <listitem><simpara>"array"</simpara></listitem> - <listitem><simpara>"object"</simpara></listitem> + <listitem> + <simpara> + "boolean" (ou, depuis PHP 4.2.0, "bool") + </simpara> + </listitem> + <listitem> + <simpara> + "integer" (ou, depuis PHP 4.2.0, "int") + </simpara> + </listitem> + <listitem> + <simpara> + "float" (uniquement depuiss PHP 4.2.0. Pour les anciennes versions, utilisez + l'alternative "double") + </simpara> + </listitem> + <listitem> + <simpara> + "string" + </simpara> + </listitem> + <listitem> + <simpara> + "array" + </simpara> + </listitem> + <listitem> + <simpara> + "object" + </simpara> + </listitem> + <listitem> + <simpara> + "null" (depuis PHP 4.2.0) + </simpara> + </listitem> </itemizedlist> </para> <para> - <function>settype</function> renvoie &true; - en cas de succ&egrave;s, &false; sinon. + &return.success; </para> <para> - Voir aussi <function>gettype</function>. + <example> + <title>Exemple avec <function>settype</function></title> + <programlisting role="php"> +<![CDATA[ +$foo = "5bar"; // string +$bar = true; // boolean + +settype($foo, "integer"); // $foo vaut maintenant 5 (integer) +settype($bar, "string"); // $bar vaut maintenant "1" (string) +]]> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>gettype</function>, + <link linkend="language.types.typecasting">transtypage</link> et + <link linkend="language.types.type-juggling">d&eacute;finition du type</link>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/strval.xml diff -u phpdoc-fr/reference/var/functions/strval.xml:1.1 phpdoc-fr/reference/var/functions/strval.xml:1.2 --- phpdoc-fr/reference/var/functions/strval.xml:1.1 Sun Apr 14 20:39:42 2002 +++ phpdoc-fr/reference/var/functions/strval.xml Sat Apr 26 15:25:47 2003 @@ -4,7 +4,7 @@ <refentry id="function.strval"> <refnamediv> <refname>strval</refname> - <refpurpose>Retourne la valeur de la variable, au format cha&icirc;ne.</refpurpose> + <refpurpose>Retourne la valeur de la variable, au format cha&icirc;ne</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/var/functions/unserialize.xml diff -u phpdoc-fr/reference/var/functions/unserialize.xml:1.1 phpdoc-fr/reference/var/functions/unserialize.xml:1.2 --- phpdoc-fr/reference/var/functions/unserialize.xml:1.1 Sun Apr 14 20:39:42 2002 +++ phpdoc-fr/reference/var/functions/unserialize.xml Sat Apr 26 15:25:47 2003 @@ -13,6 +13,7 @@ <methodsynopsis> <type>mixed</type><methodname>unserialize</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>callback</parameter></methodparam> </methodsynopsis> <simpara> <function>unserialize</function> prend une variable lin&eacute;aris&eacute;e @@ -22,18 +23,74 @@ <type>string</type>, <type>array</type> ou <type>object</type>. Les objets lin&eacute;aris&eacute;s perdent leurs m&eacute;thodes. </simpara> + <note> + <title>Directive unserialize_callback_func</title> + <para> + Il est possible de d&eacute;finir une fonction de callback qui sera + appel&eacute;e si une classe und&eacute;finie est utilis&eacute;e lors + de la d&eacute;lin&eacute;arisation + (ce qui &eacute;vitera de voir l'objet recevoir le type + d'objet incomplet <type>object</type> "__PHP_Incomplete_Class"). + Utilisez dans votre fichier &php.ini; ou le fichier &htaccess;, + ou encore avec la fonction <function>ini_set</function>, pour d&eacute;finir + une fonction 'unserialize_callback_func'. Chaque fois qu'une classe non + d&eacute;finie sera instanti&eacute;e, cette fonction sera appel&eacute;e. + Pour d&eacute;sactiver cette fonctionnalit&eacute;, laissez la simplement + vide. Notez aussi que cette directive n'est disponible que depuis PHP 4.2.0. + </para> + </note> + <note> + <para> + Le param&egrave;tre <parameter>callback</parameter> est disponible depuis PHP 4.2.0. + </para> + </note> + <para> + Si la variable d&eacute;lin&eacute;aris&eacute;e est un objet, apr&egrave;s avoir r&eacute;ussi &agrave; le + reconstruire, PHP appelera automatiquement la m&eacute;thode + __wakeup() si elle existe. + <example> + <title>Exemple avec la directive unserialize_callback_func</title> + <programlisting role="php"> +<![CDATA[ +<?php + $serialized_object='O:1:"a":1:{s:5:"value";s:3:"100";}'; + + // directive unserialize_callback_func disponible depuis PHP 4.2.0 + ini_set('unserialize_callback_func','moncallback'); + // configure votre fonction de callback : moncallbackfunction + + function moncallback($classname) { + // Incluez simplement in fichier contenant votre d&eacute;finition de classe + // vous saurez quelle classe gr&acirc;ce &agrave; $classname + } +?> +]]> + </programlisting> + </example> + </para> + <note> + <para> + En PHP 3, les m&eacute;thodes ne sont pas pr&eacute;serv&eacute;es lors de la + d&eacute;lin&eacute;arisation d'un bojet. PHP 4 l&egrave;ve cette limitation, et + stocke d&eacute;sormais les m&eacute;thodes et les membres. Voyez le chapitre sur + la <link linkend="language.oop.serialization">Lin&eacute;arisation des objets</link> + du chapitre <link linkend="language.oop">Classes et + Objets</link>. + </para> + </note> <para> <example> <title>Exemple avec <function>unserialize</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // Ici, on utilise <function>unserialize</function> pour charger les donn&eacute;es de sessions // depuis la base de donn&eacute;es, dans $session_data. Cet exemple compl&egrave;te // celui fourni avec <function>serialize</function>. $conn = odbc_connect ("webdb", "php", "chicken"); $stmt = odbc_prepare ($conn, "SELECT data FROM sessions WHERE id = ?"); $sqldata = array ($PHP_AUTH_USER); -if (!odbc_execute ($stmt, &amp;$sqldata) || !odbc_fetch_into ($stmt, &amp;$tmp)) { +if (!odbc_execute ($stmt, &$sqldata) || !odbc_fetch_into ($stmt, &$tmp)) { // si la pr&eacute;paration ou la lecture &eacute;choue, on cr&eacute;e un tableau vide $session_data = array(); } else { @@ -44,10 +101,15 @@ $session_data = array(); } } -?&gt; +?> +]]> </programlisting> </example> </para> + <para> + Voir aussi + <function>serialize</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/var/functions/unset.xml diff -u phpdoc-fr/reference/var/functions/unset.xml:1.1 phpdoc-fr/reference/var/functions/unset.xml:1.2 --- phpdoc-fr/reference/var/functions/unset.xml:1.1 Sun Apr 14 20:39:42 2002 +++ phpdoc-fr/reference/var/functions/unset.xml Sat Apr 26 15:25:47 2003 @@ -27,14 +27,16 @@ <example> <title>Exemple avec <function>unset</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // Destruction d'une seule variable unset ($foo); // Destruction d'un &eacute;l&eacute;ment de tableau unset ($bar['quux']); // Destruction de plusieurs variables unset ($foo1, $foo2, $foo3); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -50,7 +52,8 @@ <function>unset</function>. <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php function destroy_foo() { global $foo; unset($foo); @@ -58,13 +61,16 @@ $foo = 'bar'; destroy_foo(); echo $foo; -?&gt; +?> +]]> </programlisting> </informalexample> L'exemple ci dessus affichera : <informalexample> <literallayout> +<![CDATA[ bar +]]> </literallayout> </informalexample> </para> @@ -75,24 +81,28 @@ qu'elle avait avant l'appel de <function>unset</function>. <informalexample> <programlisting role="php"> -&lt;?php -function foo(&amp;$bar) { +<![CDATA[ +<?php + function foo(&$bar) { unset($bar); $bar = "bla"; -} -$bar = 'truc'; -echo "$bar\n"; -foo($bar); -echo "$bar\n"; -?&gt; + } + $bar = 'truc'; + echo "$bar\n"; + foo($bar); + echo "$bar\n"; +?> +]]> </programlisting> </informalexample> L'exemple ci dessus va afficher : <informalexample> <literallayout> <computeroutput> +<![CDATA[ truc truc +]]> </computeroutput> </literallayout> </informalexample> @@ -103,26 +113,30 @@ statique, plut&ocirc;t que la variable statique elle m&ecirc;me. <informalexample> <programlisting role="php"> -&lt;?php -function foo() { +<![CDATA[ +<?php + function foo() { static $a; $a++; echo "$a\n"; unset($a); -} -foo(); -foo(); -foo(); -?&gt; + } + foo(); + foo(); + foo(); +?> +]]> </programlisting> </informalexample> L'affichage du script ci-dessus donnera : <informalexample> <literallayout> <computeroutput> +<![CDATA[ 1 2 3 +]]> </computeroutput> </literallayout> </informalexample> @@ -130,16 +144,19 @@ <para> Si vous voulez d&eacute;truire une variable globale, depuis une fonction, vous pouvez utiliser le tableau - <parameter>$GLOBALS</parameter> : + <parameter>$globals</parameter> : <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php + function foo() { unset($GLOBALS['bar']); } $bar = "truc"; foo(); -?&gt; +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/var/functions/var-dump.xml diff -u phpdoc-fr/reference/var/functions/var-dump.xml:1.2 phpdoc-fr/reference/var/functions/var-dump.xml:1.3 --- phpdoc-fr/reference/var/functions/var-dump.xml:1.2 Tue Apr 1 07:31:43 2003 +++ phpdoc-fr/reference/var/functions/var-dump.xml Sat Apr 26 15:25:47 2003 @@ -11,29 +11,63 @@ <refsect1> <title>Description</title> <methodsynopsis> - - <type>void</type><methodname>var_dump</methodname> - <methodparam><type>mixed</type><parameter>expression</parameter></methodparam> + <type>void</type><methodname>var_dump</methodname> + <methodparam><type>mixed</type><parameter>expression</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>expression</parameter></methodparam> + <methodparam choice="opt"><parameter>...</parameter></methodparam> </methodsynopsis> <simpara> - Cette fonction affiche les informations structur&eacute;es d'une variable, + <function>var_dump</function> retourne les informations structur&eacute;es d'une variable, y compris son type et sa valeur. Les tableaux sont explor&eacute;s recursivement, avec des indentations, pour mettre en valeur leur structure. </simpara> + &tip.ob-capture; <simpara> Comparez <function>var_dump</function> et <function>print_r</function>. </simpara> <para> - <informalexample> + <example> + <title>Exemple avec <function>var_dump</function></title> <programlisting role="php"> -&lt;pre> -&lt;?php - $a = array (1, 2, array ("a", "b", "c")); - var_dump ($a); -?&gt; -&lt;/pre> +<![CDATA[ +<PRE> +<?php +$a = array (1, 2, array ("a", "b", "c")); +var_dump ($a); + +/* affichage : +array(3) { + [0]=> + int(1) + [1]=> + int(2) + [2]=> + array(3) { + [0]=> + string(1) "a" + [1]=> + string(1) "b" + [2]=> + string(1) "c" + } +} + +*/ + +$b = 3.1; +$c = TRUE; +var_dump($b,$c); + +/* affichage : +float(3.1) +bool(true) + +*/ +?> +</PRE> +]]> </programlisting> - </informalexample> + </example> </para> </refsect1> </refentry>
« previous php.doc.fr (#304) next »