cvs: phpdoc /fr/functions imap.xml info.xml ingres_ii.xml ircg.xml
| From: | Damien Seguy | Date: | Wed, 14 Nov 2001 21:06:23 +0000 |
| Subject: | cvs: phpdoc /fr/functions imap.xml info.xml ingres_ii.xml ircg.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338849@lists.php.net to get a copy of this message | ||
dams Wed Nov 14 16:06:23 2001 EDT
Modified files:
/phpdoc/fr/functions info.xml ingres_ii.xml ircg.xml imap.xml
Log:
Gathering of minor update since July.
Index: phpdoc/fr/functions/info.xml diff -u phpdoc/fr/functions/info.xml:1.18 phpdoc/fr/functions/info.xml:1.19 --- phpdoc/fr/functions/info.xml:1.18 Wed Aug 8 05:43:01 2001 +++ phpdoc/fr/functions/info.xml Wed Nov 14 16:06:23 2001 @@ -1,4 +1,5 @@ -<!-- $Revision: 1.18 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.19 $ --> <reference id="ref.info"> <title>Options PHP et informations</title> <titleabbrev>Options et informations PHP</titleabbrev> @@ -18,7 +19,7 @@ <para> <function>assert</function> va vérifier l'assertion <parameter>assertion</parameter> et prendre la mesure appropriée - si le résultat est <literal>FALSE</literal>. + si le résultat est &false;. </para> <para> Si <parameter>assertion</parameter> est donnée sous la forme @@ -119,7 +120,7 @@ </table> <para> <function>assert_options</function> retourne la valeur originale - de l'option, ou bien <literal>FALSE</literal> en cas d'erreur. + de l'option, ou bien &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -139,7 +140,7 @@ </funcprototype> </funcsynopsis> <simpara> - <function>extension_loaded</function> retourne <literal>TRUE</literal> si l'extension + <function>extension_loaded</function> retourne &true; si l'extension <parameter>name</parameter> a été chargée. Vous pouvez voir les différents noms des extensions, en utilisant la fonction <function>phpinfo</function>. @@ -170,8 +171,12 @@ </funcsynopsis> <para> <function>dl</function> charge l'extension PHP <parameter>library</parameter> - à la volée . Voir aussi la directive de configuration - <link linkend="ini.extension-dir">extension_dir</link>. + à la volée . + </para> + <para> + Voir aussi les directives de configuration + <link linkend="ini.extension-dir">extension_dir</link> et + <link linkend="ini.enable-dl">enable_dl</link>. </para> </refsect1> </refentry> @@ -191,7 +196,7 @@ <para> <function>getenv</function> retourne la valeur de la variable d'environnement <parameter>varname</parameter>, - ou <literal>FALSE</literal> en cas d'erreur. + ou &false; en cas d'erreur. <informalexample> <programlisting role="php"> <?php @@ -230,7 +235,7 @@ <simpara> <function>get_cfg_var</function> retourne la valeur courante de l'option PHP <parameter>varname</parameter>, ou bien - <literal>FALSE</literal> en cas d'erreur. + &false; en cas d'erreur. </simpara> <simpara> <function>get_cfg_var</function> ne retourne pas les options qui @@ -273,156 +278,455 @@ </simpara> </refsect1> </refentry> - <refentry id="function.get-magic-quotes-gpc"> + <refentry id="function.get-defined-constants"> <refnamediv> - <refname>get_magic_quotes_gpc</refname> + <refname>get_defined_constants</refname> <refpurpose> - Retourne la configuration actuelle de l'option magic_quotes_gpc. + Retourne la liste des constantes et leur valeur </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>long <function>get_magic_quotes_gpc</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_defined_constants</function></funcdef> + <void/> </funcprototype> </funcsynopsis> - <simpara> - <function>get_magic_quotes_gpc</function> retourne la configuration actuelle - de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - (0 pour l'option désactivée, 1 pour l'option activée). - </simpara> - <simpara> + <para> + <function>get_defined_constants</function> retourne les noms et + valeurs des constantes déjà définies. Cela inclut + les constantes créées par les extensions, et celles + créées avec la fonction <function>define</function>. + </para> + <para> + Par exemple : + <informalexample> + <programlisting> +<?php + print_r(get_defined_constants()); +?> + </programlisting> + </informalexample> + affichera + <informalexample> + <programlisting> +Array +( + [E_ERROR] => 1 + [E_WARNING] => 2 + [E_PARSE] => 4 + [E_NOTICE] => 8 + [E_CORE_ERROR] => 16 + [E_CORE_WARNING] => 32 + [E_COMPILE_ERROR] => 64 + [E_COMPILE_WARNING] => 128 + [E_USER_ERROR] => 256 + [E_USER_WARNING] => 512 + [E_USER_NOTICE] => 1024 + [E_ALL] => 2047 + [TRUE] => 1 +) + </programlisting> + </informalexample> + </para> + <para> Voir aussi - <function>get_magic_quotes_runtime</function> et - <function>set_magic_quotes_runtime</function>. - </simpara> + <function>get_loaded_extensions</function>. + </para> </refsect1> </refentry> - <refentry id="function.get-magic-quotes-runtime"> + <refentry id="function.get-extension-funcs"> <refnamediv> - <refname>get_magic_quotes_runtime</refname> + <refname>get_extension_funcs</refname> <refpurpose> - Retourne la configuration actuelle de l'option magic_quotes_runtime. + Liste les fonctions d'une extension </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>long <function>get_magic_quotes_runtime</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_extension_funcs</function></funcdef> + <paramdef>string <parameter>module_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_extension_funcs</function> retourne le nom des fonctions + définies dans le module <parameter>module_name</parameter>. + </para> + <para> + Par exemple, les lignes suivantes : + <informalexample> + <programlisting role="php"> +<?php +print_r(get_extension_funcs("xml")); +print_r(get_extension_funcs("gd")); +?> + </programlisting> + </informalexample> + vont afficher la liste des fonctions disponibles avec les modules + <varname>xml</varname> et <varname>gd</varname>. + </para> + <para> + Voir aussi + <function>get_loaded_extensions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmygid"> + <refnamediv> + <refname>getmygid</refname> + <refpurpose>Retourne le GID du propriétaire du script</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmygid</function></funcdef> + <void/> </funcprototype> </funcsynopsis> <simpara> - <function>get_magic_quotes_runtime</function> retourne la configuration - actuelle de l'option - <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. - (0 pour option désactivée, 1 pour option activée). + <function>getmygid</function> retourne le GID du propriétaire du script, + ou &false; en cas d'erreur. </simpara> <simpara> Voir aussi - <function>get_magic_quotes_gpc</function> et - <function>set_magic_quotes_runtime</function>. + <function>getmyuid</function>, + <function>getmypid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. </simpara> </refsect1> </refentry> - <refentry id="function.getlastmod"> + <refentry id="function.get-included-files"> <refnamediv> - <refname>getlastmod</refname> + <refname>get_included_files</refname> <refpurpose> - Retourne la date de dernière modification de la page. + Retourne un tableau avec les noms des fichiers qui sont inclus + dans un script </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>getlastmod</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_included_files</function></funcdef> + <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> - <function>getlastmod</function> retourne la date de dernière - modification de la page. La valeur retournée est - un marqueur de temps UNIX, utilisable comme paramètre avec - la fonction <function>date</function>. - <function>getlastmod</function> retourne <literal>FALSE</literal> en - cas d'erreur. + <function>get_included_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + ajoutés au script avec les fonctions <function>require_once</function> ou + <function>include_once</function>. + </para> + <para> + L'exemple ci-dessous <example> - <title>Exemple avec <function>getlastmod</function></title> - <programlisting role="php"> + <title>Affichage des fichiers inclus et requis</title> + <programlisting> <?php -// affiche 'Dernière modification: March 04 1998 20:43:59.' - echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); +require_once("local.php"); +require_once("../inc/global.php"); +for ($i=1; $i<5; $i++) + include "util".$i.".php"; + echo "Fichiers appelés avec required_once/included_once\n"; + print_r(get_required_files()); ?> </programlisting> </example> + va afficher : + <informalexample> + <programlisting> +Fichiers appelés avec required_once/included_once +Array +( + [0] => local.php + [1] => /full/path/to/inc/global.php + [2] => util1.php + [3] => util2.php + [4] => util3.php + [5] => util4.php +) + </programlisting> + </informalexample> </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> + </para> + </note> <para> Voir aussi - <function>date</function>, - <function>getmyuid</function>, - <function>get_current_user</function>, - <function>getmyinode</function> et - <function>getmypid</function>. + <function>require_once</function>, + <function>include_once</function> et + <function>get_required_files</function>. </para> </refsect1> </refentry> - <refentry id="function.getmyinode"> + <refentry id="function.get-loaded-extensions"> <refnamediv> - <refname>getmyinode</refname> - <refpurpose>Retourne l'inode du script.</refpurpose> + <refname>get_loaded_extensions</refname> + <refpurpose> + Retourne la liste de tous les modules compilés et chargés + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>getmyinode</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_loaded_extensions</function></funcdef> + <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> - <function>getmyinode</function> retourne l'inode du script, - ou <literal>FALSE</literal> en cas d'erreur. + <function>get_loaded_extensions</function> retourne un tableau contenant + les noms de tous les modules compilés et chargés sur + l'interpreteur PHP courant. + </para> + <para> + Par exemple, la ligne ci-dessous + <informalexample> + <programlisting role="php"> +<?php +print_r(get_loaded_extensions()); +?> + </programlisting> + </informalexample> + affichera la liste suivante : + <informalexample> + <literallayout> + <computeroutput> +Array +( + [0] => xml + [1] => wddx + [2] => standard + [3] => session + [4] => posix + [5] => pgsql + [6] => pcre + [7] => gd + [8] => ftp + [9] => db + [10] => Calendar + [11] => bcmath +) + </computeroutput> + </literallayout> + </informalexample> </para> <para> Voir aussi - <function>getmyuid</function>, - <function>get_current_user</function>, - <function>getmypid</function> et - <function>getlastmod</function>. + <function>get_extension_funcs</function>. </para> - <note> - <simpara> - <function>getmyinode</function> est inopérante sur les systèmes Windows. - </simpara> - </note> </refsect1> </refentry> - <refentry id="function.getmypid"> + <refentry id="function.get-required-files"> <refnamediv> - <refname>getmypid</refname> - <refpurpose>Retourne le numéro de processus courant.</refpurpose> + <refname>get_required_files</refname> + <refpurpose> + Retourne un tableau avec les noms des fichiers qui sont requis + et inclus dans un script + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>getmypid</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_required_files</function></funcdef> + <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> - <function>getmypid</function> retourne le numéro de processus - actuel ou <literal>FALSE</literal> en cas d'erreur. - </para> - <para> - Il est à noter que si vous utilisez PHP comme module Apache, - il n'est pas garanti que deux invocations distinctes de la fonction - donnent des résultats différents. - </para> + <function>get_required_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + chargés dans un script avec la fonction + <function>require_once</function> ou <function>include_once</function>. + Les index de ces tableaux sont les noms des fichiers + utilisés dans les fonctions <function>require_once</function> + ou <function>include_once</function>. + </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> + </para> + <para> + Depuis PHP 4.0.4, cette fonction est un alias de + <function>get_included_files</function> + </para> + </note> + <para> + Voir aussi + <function>require_once</function>, + <function>include_once</function> et + <function>get_included_files</function> + </para> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-gpc"> + <refnamediv> + <refname>get_magic_quotes_gpc</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_gpc. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>get_magic_quotes_gpc</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_gpc</function> retourne la configuration actuelle + de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> + (0 pour l'option désactivée, 1 pour l'option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_runtime</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-runtime"> + <refnamediv> + <refname>get_magic_quotes_runtime</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_runtime. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>get_magic_quotes_runtime</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_runtime</function> retourne la configuration + actuelle de l'option + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. + (0 pour option désactivée, 1 pour option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_gpc</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getlastmod"> + <refnamediv> + <refname>getlastmod</refname> + <refpurpose> + Retourne la date de dernière modification de la page. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getlastmod</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getlastmod</function> retourne la date de dernière + modification de la page. La valeur retournée est + un marqueur de temps UNIX, utilisable comme paramètre avec + la fonction <function>date</function>. + <function>getlastmod</function> retourne &false; en + cas d'erreur. + <example> + <title>Exemple avec <function>getlastmod</function></title> + <programlisting role="php"> +<?php +// affiche 'Dernière modification: March 04 1998 20:43:59.' + echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function>, + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getmypid</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmyinode"> + <refnamediv> + <refname>getmyinode</refname> + <refpurpose>Retourne l'inode du script.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmyinode</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getmyinode</function> retourne l'inode du script, + ou &false; en cas d'erreur. + </para> + <para> + Voir aussi + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmypid</function> et + <function>getlastmod</function>. + </para> + <note> + <simpara> + <function>getmyinode</function> est inopérante sur les systèmes Windows. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.getmypid"> + <refnamediv> + <refname>getmypid</refname> + <refpurpose>Retourne le numéro de processus courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmypid</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getmypid</function> retourne le numéro de processus + actuel ou &false; en cas d'erreur. + </para> + <para> + Il est à noter que si vous utilisez PHP comme module Apache, + il n'est pas garanti que deux invocations distinctes de la fonction + donnent des résultats différents. + </para> <warning> <para> Les identifiants de processus ne sont pas uniques, @@ -455,7 +759,7 @@ </funcsynopsis> <simpara> <function>getmyuid</function> retourne l'UID du propriétaire - du script actuel ou <literal>FALSE</literal> en cas d'erreur. + du script actuel ou &false; en cas d'erreur. </simpara> <simpara> Voir aussi @@ -525,7 +829,7 @@ <function>ini_alter</function> change la valeur de l'option de configuration <parameter>varname</parameter> et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_alter</function> retourne <literal>FALSE</literal> + <function>ini_alter</function> retourne &false; en cas d'échec, et la valeur précédente en cas de succès. </para> @@ -558,7 +862,7 @@ <para> <function>ini_get</function> retourne la valeur de l'option de configuration <parameter>varname</parameter> en cas de succès, et - <literal>FALSE</literal>. + &false;. </para> <para> Voir aussi @@ -568,6 +872,37 @@ </para> </refsect1> </refentry> + <refentry id="function.ini-get-all"> + <refnamediv> + <refname>ini_get_all</refname> + <refpurpose>Lit toutes les valeurs de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ini_get_all</function></funcdef> + <paramdef>string + <parameter><optional>extension</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_get_all</function> retourne toutes les + valeurs de configuration sous la forme d'un tableau associatif. + Si le paramètre optionnel <parameter>extension</parameter> est + fourni, <function>ini_get_all</function> retourne uniquement + les configurations concernant cette extension. + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_restore</function>, + <function>ini_get</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> <refentry id="function.ini-restore"> <refnamediv> <refname>ini_restore</refname> @@ -611,7 +946,7 @@ <function>ini_set</function> change la valeur de l'option de configuration <parameter>varname</parameter> et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_set</function> retourne <literal>FALSE</literal> + <function>ini_set</function> retourne &false; en cas d'échec, et la valeur précédente en cas de succès. La valeur de l'option de configuration sera modifiée durant toute @@ -732,7 +1067,7 @@ <row> <entry>magic_quotes_gpc</entry> <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>magic_quotes_runtime</entry> @@ -742,7 +1077,7 @@ <row> <entry>magic_quotes_sybase</entry> <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>output_buffering</entry> @@ -1099,6 +1434,7 @@ </para> <para> Voir aussi + <function>version_compare</function>, <function>phpinfo</function>, <function>phpversion</function> et <function>php_logo_guid</function>. @@ -1417,277 +1753,67 @@ </para> </refsect1> </refentry> - <refentry id="function.get-defined-constants"> - <refnamediv> - <refname>get_defined_constants</refname> - <refpurpose> - Retourne la liste des constantes et leur valeur - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_defined_constants</function></funcdef> - <void/> - </funcprototype> - </funcsynopsis> - <para> - <function>get_defined_constants</function> retourne les noms et - valeurs des constantes déjà définies. Cela inclus les constantes créées - par les extensions, et celles créées avec la fonction <function>define</function>. - </para> - <para> - Par exemple : - <informalexample> - <programlisting> -<?php -print_r (get_defined_constants()); -?> - </programlisting> - </informalexample> - affichera - <informalexample> - <programlisting> -Array -( - [E_ERROR] => 1 - [E_WARNING] => 2 - [E_PARSE] => 4 - [E_NOTICE] => 8 - [E_CORE_ERROR] => 16 - [E_CORE_WARNING] => 32 - [E_COMPILE_ERROR] => 64 - [E_COMPILE_WARNING] => 128 - [E_USER_ERROR] => 256 - [E_USER_WARNING] => 512 - [E_USER_NOTICE] => 1024 - [E_ALL] => 2047 - [TRUE] => 1 -) - </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>get_loaded_extensions</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-loaded-extensions"> - <refnamediv> - <refname>get_loaded_extensions</refname> - <refpurpose> - Retourne la liste de tous les modules compilés et chargés - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_loaded_extensions</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_loaded_extensions</function> retourne un tableau contenant - les noms de tous les modules compilés et chargés sur - l'interpreteur PHP courant. - </para> - <para> - Par exemple, la ligne ci-dessous - <informalexample> - <programlisting role="php"> -<?php -print_r(get_loaded_extensions()); -?> - </programlisting> - </informalexample> - affichera la liste suivante : - <informalexample> - <literallayout> - <computeroutput> -Array -( - [0] => xml - [1] => wddx - [2] => standard - [3] => session - [4] => posix - [5] => pgsql - [6] => pcre - [7] => gd - [8] => ftp - [9] => db - [10] => Calendar - [11] => bcmath -) - </computeroutput> - </literallayout> - </informalexample> - </para> - <para> - Voir aussi - <function>get_extension_funcs</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-extension-funcs"> - <refnamediv> - <refname>get_extension_funcs</refname> - <refpurpose> - Liste les fonctions d'une extension - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_extension_funcs</function></funcdef> - <paramdef>string <parameter>module_name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_extension_funcs</function> retourne le nom des fonctions - définies dans le module <parameter>module_name</parameter>. - </para> - <para> - Par exemple, les lignes suivantes : - <informalexample> - <programlisting role="php"> -<?php -print_r(get_extension_funcs("xml")); -print_r(get_extension_funcs("gd")); -?> - </programlisting> - </informalexample> - vont afficher la liste des fonctions disponibles avec les modules - <varname>xml</varname> et <varname>gd</varname>. - </para> - <para> - Voir aussi - <function>get_loaded_extensions</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-required-files"> - <refnamediv> - <refname>get_required_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont requis - et inclus dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_required_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_required_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - chargés dans un script avec la fonction - <function>require_once</function> ou <function>include_once</function>. - Les index de ces tableaux sont les noms des fichiers - utilisés dans les fonctions <function>require_once</function> - ou <function>include_once</function>. - </para> - <note> + <refentry id="function.version-compare"> + <refnamediv> + <refname>version_compare</refname> + <refpurpose>Compare deux versions de PHP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>version_compare</function></funcdef> + <paramdef>string <parameter>version1</parameter></paramdef> + <paramdef>string <parameter>version2</parameter></paramdef> + <paramdef>string + <parameter> + <optional>operator</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> + <function>version_compare</function> compare + les deux versions de PHP standardisée. Cette fonction est pratique + pour les programmes qui doivent vérifier la version de PHP qui les + fait tourner. </para> <para> - Depuis PHP 4.0.4, cette fonction est un alias de - <function>get_included_files</function> + <function>version_compare</function> retourne -1 si + <parameter>version1</parameter> est inférieure à <parameter>version2</parameter>, + 0 si elles sont égales, et 1 dans le reste des cas. </para> - </note> - <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et - <function>get_included_files</function> - </para> - </refsect1> - </refentry> - <refentry id="function.get-included-files"> - <refnamediv> - <refname>get_included_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont inclus - dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_included_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_included_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - ajoutés au script avec les fonctions <function>require_once</function> ou - <function>include_once</function>. - </para> - <para> - L'exemple ci-dessous - <example> - <title>Affichage des fichiers inclus et requis</title> - <programlisting> + <para> + Si vous spécifiez le troisième argument optionnel + <parameter>operator</parameter>, vous pouvez tester une + relation particulière. Les opérateurs possibles sont + <literal><</literal>, + <literal>lt</literal>, <literal><=</literal>, + <literal>le</literal>, <literal>></literal>, + <literal>gt</literal>, <literal>>=</literal>, + <literal>ge</literal>, <literal>==</literal>, + <literal>=</literal>, <literal>eq</literal>, + <literal>!=</literal>, <literal><></literal>, + <literal>ne</literal>. En utilisant cet argument, + <function>version_compare</function> retournera 1 si la + relation est vérifiée et 0 sinon. + </para> + <para> + <example> + <title>Exemple avec <function>version_compare</function></title> + <programlisting role="php"> <?php -require_once("local.php"); -require_once("../inc/global.php"); -for ($i=1; $i<5; $i++) - include "util".$i.".php"; - echo "Fichiers appelés avec required_once/included_once\n"; - print_r(get_required_files()); +echo version_compare("4.0.4", "4.0.6"); +// affiche -1 +echo version_compare("4.0.4", "4.0.6", "<"); +echo version_compare("4.0.6", "4.0.6", "eq"); +// affichent tous 1 ?> - </programlisting> - </example> - va afficher : - <informalexample> - <programlisting> -Fichiers appelés avec required_once/included_once -Array -( - [0] => local.php - [1] => /full/path/to/inc/global.php - [2] => util1.php - [3] => util2.php - [4] => util3.php - [5] => util4.php -) - </programlisting> - </informalexample> - </para> - <note> - <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> + </programlisting> + </example> </para> - </note> - <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et - <function>get_required_files</function>. - </para> - </refsect1> - </refentry> + </refsect1> + </refentry> <refentry id="function.zend-version"> <refnamediv> <refname>zend_version</refname> Index: phpdoc/fr/functions/ingres_ii.xml diff -u phpdoc/fr/functions/ingres_ii.xml:1.8 phpdoc/fr/functions/ingres_ii.xml:1.9 --- phpdoc/fr/functions/ingres_ii.xml:1.8 Wed Aug 8 05:44:39 2001 +++ phpdoc/fr/functions/ingres_ii.xml Wed Nov 14 16:06:23 2001 @@ -1,4 +1,5 @@ -<!-- $Revision: 1.8 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.ingres"> <title>Ingres II</title> <titleabbrev>Ingres II</titleabbrev> @@ -64,7 +65,7 @@ </funcsynopsis> <para> <function>ingres_connect</function> retourne une ressource représentant un - lien Ingres II en cas de succès, et <literal>FALSE</literal> sinon. + lien Ingres II en cas de succès, et &false; sinon. </para> <para> <function>ingres_connect</function> établit une connexion avec la @@ -114,7 +115,8 @@ </programlisting> </example> <para> - Voir aussi <function>ingres_pconnect</function>, et + Voir aussi + <function>ingres_pconnect</function> et <function>ingres_close</function>. </para> </refsect1> @@ -144,7 +146,7 @@ </funcsynopsis> <para> <function>ingres_pconnect</function> retourne une ressource représentant un - lien (link) Ingres II en cas de succès, et <literal>FALSE</literal> sinon. + lien (link) Ingres II en cas de succès, et &false; sinon. </para> <para> Voir <function>ingres_connect</function> pour le détail des paramètres @@ -161,7 +163,9 @@ est dit 'persistant'. </para> <para> - Voir aussi <function>ingres_connect</function> et <function>ingres_close</function>. + Voir aussi + <function>ingres_connect</function> et + <function>ingres_close</function>. </para> </refsect1> </refentry> @@ -181,8 +185,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_close</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> sinon. + <function>ingres_close</function> retourne &true; + en cas de succès, et &false; sinon. </para> <para> <function>ingres_close</function> ferme la connexion au serveur Ingres @@ -197,7 +201,8 @@ script. </para> <para> - Voir aussi <function>ingres_connect</function> et + Voir aussi + <function>ingres_connect</function> et <function>ingres_pconnect</function>. </para> </refsect1> @@ -221,8 +226,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_query</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> sinon. + <function>ingres_query</function> retourne &true; + en cas de succès, et &false; sinon. </para> <para> <function>ingres_query</function> envoie la requête @@ -362,7 +367,7 @@ <simpara> Il faut dans ce cas récupérer les données du résultat en utilisant une de ces 3 fonctions dans une boucle jusqu'à ce qu'elle renvoie - <literal>FALSE</literal>, ce qui indique qu'il n'y a plus de résultats à récupérer. + &false;, ce qui indique qu'il n'y a plus de résultats à récupérer. </simpara> </note> </para> @@ -428,7 +433,7 @@ </funcsynopsis> <para> <function>ingres_field_name</function> retourne le nom d'un champ dans - le résultat d'une requête, ou <literal>FALSE</literal> en cas d'échec. + le résultat d'une requête, ou &false; en cas d'échec. </para> <para> <parameter>index</parameter> est le numéro du champ et doit être compris @@ -465,7 +470,7 @@ </funcsynopsis> <para> <function>ingres_field_type</function> retourne le type d'un champ dans - le résultat d'une requête, ou <literal>FALSE</literal> en cas d'échec. + le résultat d'une requête, ou &false; en cas d'échec. Exemples de types renvoyés par cette fonction : "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Certains de ces types @@ -507,8 +512,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_field_nullable</function> retourne <literal>TRUE</literal> si le champ - peut recevoir la valeur NULL et <literal>FALSE</literal> dans le cas contraire. + <function>ingres_field_nullable</function> retourne &true; si le champ + peut recevoir la valeur NULL et &false; dans le cas contraire. </para> <para> <parameter>index</parameter> est le numéro du champ et doit être compris @@ -656,7 +661,7 @@ </funcsynopsis> <para> <function>ingres_fetch_array</function> renvoie un tableau correspondant - à la ligne récupérée, ou <literal>FALSE</literal> s'il n'y a plus de ligne à récupérer. + à la ligne récupérée, ou &false; s'il n'y a plus de ligne à récupérer. </para> <para> Cette fonction est une version améliorée de @@ -740,14 +745,14 @@ <para> <function>ingres_fetch_row</function> renvoie un tableau correspondant à la ligne récupérée, ou - <literal>FALSE</literal> s'il n'y a plus de ligne à + &false; s'il n'y a plus de ligne à récupérer. La ligne est stockée dans un tableau à indices numériques, le premier champs étant à l'indice 1. </para> <para> Les appels successifs à <function>ingres_fetch_row</function> retournent - les lignes suivantes du résultat, ou <literal>FALSE</literal> s'il n'y a plus de lignes. + les lignes suivantes du résultat, ou &false; s'il n'y a plus de lignes. </para> <para> <example> @@ -794,7 +799,7 @@ <para> <function>ingres_fetch_object</function> renvoie un objet correspondant à la ligne (tuple) récupérée, ou - <literal>FALSE</literal> s'il n'y a plus de ligne à récupérer. + &false; s'il n'y a plus de ligne à récupérer. </para> <para> <function>ingres_fetch_object</function> est similaire à Index: phpdoc/fr/functions/ircg.xml diff -u phpdoc/fr/functions/ircg.xml:1.2 phpdoc/fr/functions/ircg.xml:1.3 --- phpdoc/fr/functions/ircg.xml:1.2 Wed Nov 14 12:52:34 2001 +++ phpdoc/fr/functions/ircg.xml Wed Nov 14 16:06:23 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <reference id="ref.ircg"> <title>IRC</title> <titleabbrev>Interface IRC</titleabbrev> @@ -165,7 +167,7 @@ canal IRC, et sinon, un utilisateur. </para> <para> - En donnant la valeur <literal>TRUE</literal> au paramètre + En donnant la valeur &true; au paramètre <parameter>suppress</parameter>, vous éviterez que vos propres messages soient affichés sur votre connexion <parameter>connection</parameter>. </para> @@ -218,8 +220,8 @@ pris. </para> <para> - <function>ircg_nick</function> retourne <literal>TRUE</literal> en - cas de succès, et <literal>FALSE</literal> + <function>ircg_nick</function> retourne &true; en + cas de succès, et &false; </para> </refsect1> </refentry> @@ -300,7 +302,7 @@ ... </para> <para> - Voir aussi: + Voir aussi </para> </refsect1> </refentry> @@ -323,7 +325,7 @@ <para> </para> <para> - Voir aussi: + Voir aussi </para> </refsect1> </refentry> @@ -377,7 +379,7 @@ </para> <para> Voir aussi - <function>ircg_ignore_del</function> . + <function>ircg_ignore_del</function>. </para> </refsect1> </refentry> @@ -452,9 +454,9 @@ </funcprototype> </funcsynopsis> <para> - <function>ircg_is_conn_alive</function> retourne <literal>TRUE</literal> + <function>ircg_is_conn_alive</function> retourne &true; si la connexion <parameter>connection</parameter> est toujours active - et fonctionnelle, et <literal>FALSE</literal> si la connexion n'est + et fonctionnelle, et &false; si la connexion n'est plus disponible. </para> </refsect1> Index: phpdoc/fr/functions/imap.xml diff -u phpdoc/fr/functions/imap.xml:1.15 phpdoc/fr/functions/imap.xml:1.16 --- phpdoc/fr/functions/imap.xml:1.15 Thu Jul 26 07:00:22 2001 +++ phpdoc/fr/functions/imap.xml Wed Nov 14 16:06:23 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.16 $ --> <reference id="ref.imap"> <title>IMAP</title> <titleabbrev>IMAP</titleabbrev> @@ -164,8 +166,8 @@ aux lettres. </para> <para> - <function>imap_append</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_append</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser @@ -312,7 +314,7 @@ <para> <function>imap_check</function> retourne les informations à propos de la boîte aux lettres courante. - <function>imap_check</function> retourne <literal>FALSE</literal> + <function>imap_check</function> retourne &false; en cas d'échec. </para> <para> @@ -431,8 +433,8 @@ encodés. </para> <para> - <function>imap_createmailbox</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_createmailbox</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> <example> @@ -480,7 +482,8 @@ </example> </para> <para> - Voir aussi <function>imap_renamemailbox</function>, + Voir aussi + <function>imap_renamemailbox</function>, <function>imap_deletemailbox</function> et <function>imap_open</function> pour connaître le format des noms de <parameter>mbox</parameter>. @@ -507,7 +510,7 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_delete</function> retourne <literal>TRUE</literal>. + <function>imap_delete</function> retourne &true;. </para> <para> <function>imap_delete</function> marque le fichier @@ -561,8 +564,8 @@ des noms de <parameter>mbox</parameter>). </para> <para> - <function>imap_deletemailbox</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_deletemailbox</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> Voir aussi @@ -617,7 +620,7 @@ l'effacement par <function>imap_delete</function>. </para> <para> - <function>imap_expunge</function> retourne <literal>TRUE</literal>. + <function>imap_expunge</function> retourne &true;. </para> </refsect1> </refentry> @@ -883,7 +886,7 @@ </row> <row> <entry>ifsubtype</entry> - <entry><literal>TRUE</literal> s'il y a une chaîne de sous type</entry> + <entry>&true; s'il y a une chaîne de sous type</entry> </row> <row> <entry>subtype</entry> @@ -891,7 +894,7 @@ </row> <row> <entry>ifdescription</entry> - <entry><literal>TRUE</literal> s'il y au ne chaîne de description</entry> + <entry>&true; s'il y au ne chaîne de description</entry> </row> <row> <entry>description</entry> @@ -899,7 +902,7 @@ </row> <row> <entry>ifid</entry> - <entry><literal>TRUE</literal> s'il y a une chaîne d'identification</entry> + <entry>&true; s'il y a une chaîne d'identification</entry> </row> <row> <entry>id</entry> @@ -915,7 +918,7 @@ </row> <row> <entry>ifdisposition</entry> - <entry><literal>TRUE</literal> s'il y a une chaîne de disposition</entry> + <entry>&true; s'il y a une chaîne de disposition</entry> </row> <row> <entry>disposition</entry> @@ -924,7 +927,7 @@ <row> <entry>ifdparameters</entry> <entry> - <literal>TRUE</literal> s'il y a un tableau de paramètres dparameters + &true; s'il y a un tableau de paramètres dparameters </entry> </row> <row> @@ -933,7 +936,7 @@ </row> <row> <entry>ifparameters</entry> - <entry><literal>TRUE</literal> si le tableau de paramètres existe</entry> + <entry>&true; si le tableau de paramètres existe</entry> </row> <row> <entry>parameters</entry> @@ -1030,7 +1033,7 @@ <parameter>quota_root</parameter>. Le quota représente la taille maximale de votre boîte aux lettres. La valeur courante est l'espace actuellement utilisé par votre boîte aux lettres. - <function>imap_get_quota</function> retournera <literal>FALSE</literal> + <function>imap_get_quota</function> retournera &false; en cas d'échec. </para> <para> @@ -1165,7 +1168,8 @@ </example> </para> <para> - Voir aussi <function>imap_getsubscribed</function>. + Voir aussi + <function>imap_getsubscribed</function>. </para> </refsect1> </refentry> @@ -1542,8 +1546,8 @@ une liste numéros de message. </para> <para> - <function>imap_mail_copy</function> retourne <literal>TRUE</literal> - en cas de succès et <literal>FALSE</literal> en cas d'erreur. + <function>imap_mail_copy</function> retourne &true; + en cas de succès et &false; en cas d'erreur. </para> <para> <parameter>flags</parameter> est un masque, qui peut contenir une ou plusieurs @@ -1603,8 +1607,8 @@ </itemizedlist> </para> <para> - <function>imap_mail_move</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_mail_move</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -1626,7 +1630,7 @@ <para> <function>imap_mailboxmsginfo</function> retourne les informations à propos de la boîte aux lettres courante. <function>imap_mailboxmsginfo</function> - retourne <literal>FALSE</literal> en cas d'échec. + retourne &false; en cas d'échec. </para> <para> <function>imap_mailboxmsginfo</function> vérifie le statut courant de @@ -1843,7 +1847,7 @@ </funcsynopsis> <para> <function>imap_open</function> retourne un flot <acronym>IMAP</acronym> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + en cas de succès, et &false; en cas d'erreur. <function>imap_open</function> peut aussi être utilisée pour ouvrir des flots sur des serveurs <acronym>POP3</acronym> et <acronym>NNTP</acronym>. </para> @@ -1944,7 +1948,7 @@ $mbox = imap_open ("{votre.hote.imap:143}", "nom_utilisateur", "mot de passe"); echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{votre.hote.imap:143}", "*"); -if ($folders == <literal>FALSE</literal>) { +if ($folders == &false;) { echo "Appel échoué<br>\n"; } else { while (list ($key, $val) = each ($folders)) { @@ -1953,7 +1957,7 @@ } echo "<p><h1>en-têtes dans INBOX</h1>\n"; $headers = imap_headers ($mbox); -if ($headers == <literal>FALSE</literal>) { +if ($headers == &false;) { echo "Appel échoué<br>\n"; } else { while (list ($key,$val) = each ($headers)) { @@ -1981,9 +1985,9 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_ping</function> retourne <literal>TRUE</literal> si + <function>imap_ping</function> retourne &true; si le flot <parameter>imap_stream</parameter> existe toujours, - et <literal>FALSE</literal> sinon. + et &false; sinon. </para> <para> <function>imap_ping</function> vérifie que le flot <acronym>IMAP</acronym> @@ -2046,11 +2050,12 @@ <parameter>old_mbox</parameter> en <parameter>new_mbox</parameter>. </para> <para> - <function>imap_renamemailbox</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_renamemailbox</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> - Voir aussi <function>imap_createmailbox</function>, + Voir aussi + <function>imap_createmailbox</function>, <function>imap_deletemailbox</function> et <function>imap_open</function> pour le format de <parameter>mbox</parameter>. </para> @@ -2469,8 +2474,8 @@ maximum (en ko) de la boîte <parameter>quota_root</parameter>. </para> <para> - <function>imap_set_quota</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> sinon. + <function>imap_set_quota</function> retourne &true; + en cas de succès, et &false; sinon. </para> <para> <example> @@ -2488,7 +2493,8 @@ </example> </para> <para> - Voir aussi <function>imap_open</function> et + Voir aussi + <function>imap_open</function> et <function>imap_set_quota</function>. </para> </refsect1> @@ -2702,8 +2708,8 @@ lettres <parameter>mbox</parameter>. </para> <para> - <function>imap_subscribe</function> retourne <literal>TRUE</literal> en cas de - succès, et <literal>FALSE</literal> en cas d'échec. + <function>imap_subscribe</function> retourne &true; en cas de + succès, et &false; en cas d'échec. </para> </refsect1> </refentry> @@ -2761,8 +2767,8 @@ <function>imap_delete</function>. </para> <para> - <function>imap_subscribe</function> retourne <literal>TRUE</literal> en cas - de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_subscribe</function> retourne &true; en cas + de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -2787,8 +2793,8 @@ la boîte aux lettres <parameter>mbox</parameter>. </para> <para> - <function>imap_unsubscribe</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_unsubscribe</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -2813,7 +2819,7 @@ </para> <para> <function>imap_utf7_decode</function> retourne les données - 8bits décodées, ou <literal>FALSE</literal> si la chaîne + 8bits décodées, ou &false; si la chaîne <parameter>text</parameter> n'est pas au format UTF-7. Cette fonction sert à décoder des noms de boîtes aux lettres qui contiennent des caractères internationaux hors de l'espace ASCII. Le standard @@ -2841,7 +2847,7 @@ </funcsynopsis> <para> <function>imap_utf7_encode</function> retourne les données - <parameter>data</parameter> 8bits encodées, ou <literal>FALSE</literal> + <parameter>data</parameter> 8bits encodées, ou &false; si une erreur est survenue. Cette fonction sert à encoder des noms de boîtes aux lettres qui contiennent des caractères internationaux
Index: phpdoc/fr/functions/info.xml diff -u phpdoc/fr/functions/info.xml:1.18 phpdoc/fr/functions/info.xml:1.19 --- phpdoc/fr/functions/info.xml:1.18 Wed Aug 8 05:43:01 2001 +++ phpdoc/fr/functions/info.xml Wed Nov 14 16:06:23 2001 @@ -1,4 +1,5 @@ -<!-- $Revision: 1.18 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.19 $ --> <reference id="ref.info"> <title>Options PHP et informations</title> <titleabbrev>Options et informations PHP</titleabbrev> @@ -18,7 +19,7 @@ <para> <function>assert</function> va vérifier l'assertion <parameter>assertion</parameter> et prendre la mesure appropriée - si le résultat est <literal>FALSE</literal>. + si le résultat est &false;. </para> <para> Si <parameter>assertion</parameter> est donnée sous la forme @@ -119,7 +120,7 @@ </table> <para> <function>assert_options</function> retourne la valeur originale - de l'option, ou bien <literal>FALSE</literal> en cas d'erreur. + de l'option, ou bien &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -139,7 +140,7 @@ </funcprototype> </funcsynopsis> <simpara> - <function>extension_loaded</function> retourne <literal>TRUE</literal> si l'extension + <function>extension_loaded</function> retourne &true; si l'extension <parameter>name</parameter> a été chargée. Vous pouvez voir les différents noms des extensions, en utilisant la fonction <function>phpinfo</function>. @@ -170,8 +171,12 @@ </funcsynopsis> <para> <function>dl</function> charge l'extension PHP <parameter>library</parameter> - à la volée . Voir aussi la directive de configuration - <link linkend="ini.extension-dir">extension_dir</link>. + à la volée . + </para> + <para> + Voir aussi les directives de configuration + <link linkend="ini.extension-dir">extension_dir</link> et + <link linkend="ini.enable-dl">enable_dl</link>. </para> </refsect1> </refentry> @@ -191,7 +196,7 @@ <para> <function>getenv</function> retourne la valeur de la variable d'environnement <parameter>varname</parameter>, - ou <literal>FALSE</literal> en cas d'erreur. + ou &false; en cas d'erreur. <informalexample> <programlisting role="php"> <?php @@ -230,7 +235,7 @@ <simpara> <function>get_cfg_var</function> retourne la valeur courante de l'option PHP <parameter>varname</parameter>, ou bien - <literal>FALSE</literal> en cas d'erreur. + &false; en cas d'erreur. </simpara> <simpara> <function>get_cfg_var</function> ne retourne pas les options qui @@ -273,156 +278,455 @@ </simpara> </refsect1> </refentry> - <refentry id="function.get-magic-quotes-gpc"> + <refentry id="function.get-defined-constants"> <refnamediv> - <refname>get_magic_quotes_gpc</refname> + <refname>get_defined_constants</refname> <refpurpose> - Retourne la configuration actuelle de l'option magic_quotes_gpc. + Retourne la liste des constantes et leur valeur </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>long <function>get_magic_quotes_gpc</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_defined_constants</function></funcdef> + <void/> </funcprototype> </funcsynopsis> - <simpara> - <function>get_magic_quotes_gpc</function> retourne la configuration actuelle - de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - (0 pour l'option désactivée, 1 pour l'option activée). - </simpara> - <simpara> + <para> + <function>get_defined_constants</function> retourne les noms et + valeurs des constantes déjà définies. Cela inclut + les constantes créées par les extensions, et celles + créées avec la fonction <function>define</function>. + </para> + <para> + Par exemple : + <informalexample> + <programlisting> +<?php + print_r(get_defined_constants()); +?> + </programlisting> + </informalexample> + affichera + <informalexample> + <programlisting> +Array +( + [E_ERROR] => 1 + [E_WARNING] => 2 + [E_PARSE] => 4 + [E_NOTICE] => 8 + [E_CORE_ERROR] => 16 + [E_CORE_WARNING] => 32 + [E_COMPILE_ERROR] => 64 + [E_COMPILE_WARNING] => 128 + [E_USER_ERROR] => 256 + [E_USER_WARNING] => 512 + [E_USER_NOTICE] => 1024 + [E_ALL] => 2047 + [TRUE] => 1 +) + </programlisting> + </informalexample> + </para> + <para> Voir aussi - <function>get_magic_quotes_runtime</function> et - <function>set_magic_quotes_runtime</function>. - </simpara> + <function>get_loaded_extensions</function>. + </para> </refsect1> </refentry> - <refentry id="function.get-magic-quotes-runtime"> + <refentry id="function.get-extension-funcs"> <refnamediv> - <refname>get_magic_quotes_runtime</refname> + <refname>get_extension_funcs</refname> <refpurpose> - Retourne la configuration actuelle de l'option magic_quotes_runtime. + Liste les fonctions d'une extension </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>long <function>get_magic_quotes_runtime</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_extension_funcs</function></funcdef> + <paramdef>string <parameter>module_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>get_extension_funcs</function> retourne le nom des fonctions + définies dans le module <parameter>module_name</parameter>. + </para> + <para> + Par exemple, les lignes suivantes : + <informalexample> + <programlisting role="php"> +<?php +print_r(get_extension_funcs("xml")); +print_r(get_extension_funcs("gd")); +?> + </programlisting> + </informalexample> + vont afficher la liste des fonctions disponibles avec les modules + <varname>xml</varname> et <varname>gd</varname>. + </para> + <para> + Voir aussi + <function>get_loaded_extensions</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmygid"> + <refnamediv> + <refname>getmygid</refname> + <refpurpose>Retourne le GID du propriétaire du script</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmygid</function></funcdef> + <void/> </funcprototype> </funcsynopsis> <simpara> - <function>get_magic_quotes_runtime</function> retourne la configuration - actuelle de l'option - <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. - (0 pour option désactivée, 1 pour option activée). + <function>getmygid</function> retourne le GID du propriétaire du script, + ou &false; en cas d'erreur. </simpara> <simpara> Voir aussi - <function>get_magic_quotes_gpc</function> et - <function>set_magic_quotes_runtime</function>. + <function>getmyuid</function>, + <function>getmypid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getlastmod</function>. </simpara> </refsect1> </refentry> - <refentry id="function.getlastmod"> + <refentry id="function.get-included-files"> <refnamediv> - <refname>getlastmod</refname> + <refname>get_included_files</refname> <refpurpose> - Retourne la date de dernière modification de la page. + Retourne un tableau avec les noms des fichiers qui sont inclus + dans un script </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>getlastmod</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_included_files</function></funcdef> + <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> - <function>getlastmod</function> retourne la date de dernière - modification de la page. La valeur retournée est - un marqueur de temps UNIX, utilisable comme paramètre avec - la fonction <function>date</function>. - <function>getlastmod</function> retourne <literal>FALSE</literal> en - cas d'erreur. + <function>get_included_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + ajoutés au script avec les fonctions <function>require_once</function> ou + <function>include_once</function>. + </para> + <para> + L'exemple ci-dessous <example> - <title>Exemple avec <function>getlastmod</function></title> - <programlisting role="php"> + <title>Affichage des fichiers inclus et requis</title> + <programlisting> <?php -// affiche 'Dernière modification: March 04 1998 20:43:59.' - echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); +require_once("local.php"); +require_once("../inc/global.php"); +for ($i=1; $i<5; $i++) + include "util".$i.".php"; + echo "Fichiers appelés avec required_once/included_once\n"; + print_r(get_required_files()); ?> </programlisting> </example> + va afficher : + <informalexample> + <programlisting> +Fichiers appelés avec required_once/included_once +Array +( + [0] => local.php + [1] => /full/path/to/inc/global.php + [2] => util1.php + [3] => util2.php + [4] => util3.php + [5] => util4.php +) + </programlisting> + </informalexample> </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> + </para> + </note> <para> Voir aussi - <function>date</function>, - <function>getmyuid</function>, - <function>get_current_user</function>, - <function>getmyinode</function> et - <function>getmypid</function>. + <function>require_once</function>, + <function>include_once</function> et + <function>get_required_files</function>. </para> </refsect1> </refentry> - <refentry id="function.getmyinode"> + <refentry id="function.get-loaded-extensions"> <refnamediv> - <refname>getmyinode</refname> - <refpurpose>Retourne l'inode du script.</refpurpose> + <refname>get_loaded_extensions</refname> + <refpurpose> + Retourne la liste de tous les modules compilés et chargés + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>getmyinode</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_loaded_extensions</function></funcdef> + <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> - <function>getmyinode</function> retourne l'inode du script, - ou <literal>FALSE</literal> en cas d'erreur. + <function>get_loaded_extensions</function> retourne un tableau contenant + les noms de tous les modules compilés et chargés sur + l'interpreteur PHP courant. + </para> + <para> + Par exemple, la ligne ci-dessous + <informalexample> + <programlisting role="php"> +<?php +print_r(get_loaded_extensions()); +?> + </programlisting> + </informalexample> + affichera la liste suivante : + <informalexample> + <literallayout> + <computeroutput> +Array +( + [0] => xml + [1] => wddx + [2] => standard + [3] => session + [4] => posix + [5] => pgsql + [6] => pcre + [7] => gd + [8] => ftp + [9] => db + [10] => Calendar + [11] => bcmath +) + </computeroutput> + </literallayout> + </informalexample> </para> <para> Voir aussi - <function>getmyuid</function>, - <function>get_current_user</function>, - <function>getmypid</function> et - <function>getlastmod</function>. + <function>get_extension_funcs</function>. </para> - <note> - <simpara> - <function>getmyinode</function> est inopérante sur les systèmes Windows. - </simpara> - </note> </refsect1> </refentry> - <refentry id="function.getmypid"> + <refentry id="function.get-required-files"> <refnamediv> - <refname>getmypid</refname> - <refpurpose>Retourne le numéro de processus courant.</refpurpose> + <refname>get_required_files</refname> + <refpurpose> + Retourne un tableau avec les noms des fichiers qui sont requis + et inclus dans un script + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>getmypid</function></funcdef> - <paramdef>void</paramdef> + <funcdef>array <function>get_required_files</function></funcdef> + <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> - <function>getmypid</function> retourne le numéro de processus - actuel ou <literal>FALSE</literal> en cas d'erreur. - </para> - <para> - Il est à noter que si vous utilisez PHP comme module Apache, - il n'est pas garanti que deux invocations distinctes de la fonction - donnent des résultats différents. - </para> + <function>get_required_files</function> retourne un tableau + contenant les noms de tous les fichiers qui ont été + chargés dans un script avec la fonction + <function>require_once</function> ou <function>include_once</function>. + Les index de ces tableaux sont les noms des fichiers + utilisés dans les fonctions <function>require_once</function> + ou <function>include_once</function>. + </para> + <note> + <para> + En PHP 4.0.1pl2, cette fonction supposait que + <varname>required_once</varname> utilisait l'extension + ".php" : les autres extensions ne fonctionnaient pas. + Par ailleurs, dans cette version, le tableau retourné était + un tableau associatif, et cette fonction n'était pas + un alias de <function>get_included_files</function> + </para> + <para> + Depuis PHP 4.0.4, cette fonction est un alias de + <function>get_included_files</function> + </para> + </note> + <para> + Voir aussi + <function>require_once</function>, + <function>include_once</function> et + <function>get_included_files</function> + </para> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-gpc"> + <refnamediv> + <refname>get_magic_quotes_gpc</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_gpc. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>get_magic_quotes_gpc</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_gpc</function> retourne la configuration actuelle + de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> + (0 pour l'option désactivée, 1 pour l'option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_runtime</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.get-magic-quotes-runtime"> + <refnamediv> + <refname>get_magic_quotes_runtime</refname> + <refpurpose> + Retourne la configuration actuelle de l'option magic_quotes_runtime. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>long <function>get_magic_quotes_runtime</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>get_magic_quotes_runtime</function> retourne la configuration + actuelle de l'option + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>. + (0 pour option désactivée, 1 pour option activée). + </simpara> + <simpara> + Voir aussi + <function>get_magic_quotes_gpc</function> et + <function>set_magic_quotes_runtime</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getlastmod"> + <refnamediv> + <refname>getlastmod</refname> + <refpurpose> + Retourne la date de dernière modification de la page. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getlastmod</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getlastmod</function> retourne la date de dernière + modification de la page. La valeur retournée est + un marqueur de temps UNIX, utilisable comme paramètre avec + la fonction <function>date</function>. + <function>getlastmod</function> retourne &false; en + cas d'erreur. + <example> + <title>Exemple avec <function>getlastmod</function></title> + <programlisting role="php"> +<?php +// affiche 'Dernière modification: March 04 1998 20:43:59.' + echo "Dernière modification: ".date( "F d Y H:i:s.", getlastmod() ); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function>, + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmyinode</function> et + <function>getmypid</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getmyinode"> + <refnamediv> + <refname>getmyinode</refname> + <refpurpose>Retourne l'inode du script.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmyinode</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getmyinode</function> retourne l'inode du script, + ou &false; en cas d'erreur. + </para> + <para> + Voir aussi + <function>getmyuid</function>, + <function>get_current_user</function>, + <function>getmypid</function> et + <function>getlastmod</function>. + </para> + <note> + <simpara> + <function>getmyinode</function> est inopérante sur les systèmes Windows. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.getmypid"> + <refnamediv> + <refname>getmypid</refname> + <refpurpose>Retourne le numéro de processus courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmypid</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getmypid</function> retourne le numéro de processus + actuel ou &false; en cas d'erreur. + </para> + <para> + Il est à noter que si vous utilisez PHP comme module Apache, + il n'est pas garanti que deux invocations distinctes de la fonction + donnent des résultats différents. + </para> <warning> <para> Les identifiants de processus ne sont pas uniques, @@ -455,7 +759,7 @@ </funcsynopsis> <simpara> <function>getmyuid</function> retourne l'UID du propriétaire - du script actuel ou <literal>FALSE</literal> en cas d'erreur. + du script actuel ou &false; en cas d'erreur. </simpara> <simpara> Voir aussi @@ -525,7 +829,7 @@ <function>ini_alter</function> change la valeur de l'option de configuration <parameter>varname</parameter> et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_alter</function> retourne <literal>FALSE</literal> + <function>ini_alter</function> retourne &false; en cas d'échec, et la valeur précédente en cas de succès. </para> @@ -558,7 +862,7 @@ <para> <function>ini_get</function> retourne la valeur de l'option de configuration <parameter>varname</parameter> en cas de succès, et - <literal>FALSE</literal>. + &false;. </para> <para> Voir aussi @@ -568,6 +872,37 @@ </para> </refsect1> </refentry> + <refentry id="function.ini-get-all"> + <refnamediv> + <refname>ini_get_all</refname> + <refpurpose>Lit toutes les valeurs de configuration</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ini_get_all</function></funcdef> + <paramdef>string + <parameter><optional>extension</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ini_get_all</function> retourne toutes les + valeurs de configuration sous la forme d'un tableau associatif. + Si le paramètre optionnel <parameter>extension</parameter> est + fourni, <function>ini_get_all</function> retourne uniquement + les configurations concernant cette extension. + </para> + <para> + Voir aussi + <function>ini_alter</function>, + <function>ini_restore</function>, + <function>ini_get</function> et + <function>ini_set</function> + </para> + </refsect1> + </refentry> <refentry id="function.ini-restore"> <refnamediv> <refname>ini_restore</refname> @@ -611,7 +946,7 @@ <function>ini_set</function> change la valeur de l'option de configuration <parameter>varname</parameter> et lui donne la valeur de <parameter>newvalue</parameter>. - <function>ini_set</function> retourne <literal>FALSE</literal> + <function>ini_set</function> retourne &false; en cas d'échec, et la valeur précédente en cas de succès. La valeur de l'option de configuration sera modifiée durant toute @@ -732,7 +1067,7 @@ <row> <entry>magic_quotes_gpc</entry> <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>magic_quotes_runtime</entry> @@ -742,7 +1077,7 @@ <row> <entry>magic_quotes_sybase</entry> <entry>"0"</entry> - <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>output_buffering</entry> @@ -1099,6 +1434,7 @@ </para> <para> Voir aussi + <function>version_compare</function>, <function>phpinfo</function>, <function>phpversion</function> et <function>php_logo_guid</function>. @@ -1417,277 +1753,67 @@ </para> </refsect1> </refentry> - <refentry id="function.get-defined-constants"> - <refnamediv> - <refname>get_defined_constants</refname> - <refpurpose> - Retourne la liste des constantes et leur valeur - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_defined_constants</function></funcdef> - <void/> - </funcprototype> - </funcsynopsis> - <para> - <function>get_defined_constants</function> retourne les noms et - valeurs des constantes déjà définies. Cela inclus les constantes créées - par les extensions, et celles créées avec la fonction <function>define</function>. - </para> - <para> - Par exemple : - <informalexample> - <programlisting> -<?php -print_r (get_defined_constants()); -?> - </programlisting> - </informalexample> - affichera - <informalexample> - <programlisting> -Array -( - [E_ERROR] => 1 - [E_WARNING] => 2 - [E_PARSE] => 4 - [E_NOTICE] => 8 - [E_CORE_ERROR] => 16 - [E_CORE_WARNING] => 32 - [E_COMPILE_ERROR] => 64 - [E_COMPILE_WARNING] => 128 - [E_USER_ERROR] => 256 - [E_USER_WARNING] => 512 - [E_USER_NOTICE] => 1024 - [E_ALL] => 2047 - [TRUE] => 1 -) - </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>get_loaded_extensions</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-loaded-extensions"> - <refnamediv> - <refname>get_loaded_extensions</refname> - <refpurpose> - Retourne la liste de tous les modules compilés et chargés - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_loaded_extensions</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_loaded_extensions</function> retourne un tableau contenant - les noms de tous les modules compilés et chargés sur - l'interpreteur PHP courant. - </para> - <para> - Par exemple, la ligne ci-dessous - <informalexample> - <programlisting role="php"> -<?php -print_r(get_loaded_extensions()); -?> - </programlisting> - </informalexample> - affichera la liste suivante : - <informalexample> - <literallayout> - <computeroutput> -Array -( - [0] => xml - [1] => wddx - [2] => standard - [3] => session - [4] => posix - [5] => pgsql - [6] => pcre - [7] => gd - [8] => ftp - [9] => db - [10] => Calendar - [11] => bcmath -) - </computeroutput> - </literallayout> - </informalexample> - </para> - <para> - Voir aussi - <function>get_extension_funcs</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-extension-funcs"> - <refnamediv> - <refname>get_extension_funcs</refname> - <refpurpose> - Liste les fonctions d'une extension - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_extension_funcs</function></funcdef> - <paramdef>string <parameter>module_name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_extension_funcs</function> retourne le nom des fonctions - définies dans le module <parameter>module_name</parameter>. - </para> - <para> - Par exemple, les lignes suivantes : - <informalexample> - <programlisting role="php"> -<?php -print_r(get_extension_funcs("xml")); -print_r(get_extension_funcs("gd")); -?> - </programlisting> - </informalexample> - vont afficher la liste des fonctions disponibles avec les modules - <varname>xml</varname> et <varname>gd</varname>. - </para> - <para> - Voir aussi - <function>get_loaded_extensions</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.get-required-files"> - <refnamediv> - <refname>get_required_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont requis - et inclus dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_required_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_required_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - chargés dans un script avec la fonction - <function>require_once</function> ou <function>include_once</function>. - Les index de ces tableaux sont les noms des fichiers - utilisés dans les fonctions <function>require_once</function> - ou <function>include_once</function>. - </para> - <note> + <refentry id="function.version-compare"> + <refnamediv> + <refname>version_compare</refname> + <refpurpose>Compare deux versions de PHP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>version_compare</function></funcdef> + <paramdef>string <parameter>version1</parameter></paramdef> + <paramdef>string <parameter>version2</parameter></paramdef> + <paramdef>string + <parameter> + <optional>operator</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> + <function>version_compare</function> compare + les deux versions de PHP standardisée. Cette fonction est pratique + pour les programmes qui doivent vérifier la version de PHP qui les + fait tourner. </para> <para> - Depuis PHP 4.0.4, cette fonction est un alias de - <function>get_included_files</function> + <function>version_compare</function> retourne -1 si + <parameter>version1</parameter> est inférieure à <parameter>version2</parameter>, + 0 si elles sont égales, et 1 dans le reste des cas. </para> - </note> - <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et - <function>get_included_files</function> - </para> - </refsect1> - </refentry> - <refentry id="function.get-included-files"> - <refnamediv> - <refname>get_included_files</refname> - <refpurpose> - Retourne un tableau avec les noms des fichiers qui sont inclus - dans un script - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>get_included_files</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>get_included_files</function> retourne un tableau - contenant les noms de tous les fichiers qui ont été - ajoutés au script avec les fonctions <function>require_once</function> ou - <function>include_once</function>. - </para> - <para> - L'exemple ci-dessous - <example> - <title>Affichage des fichiers inclus et requis</title> - <programlisting> + <para> + Si vous spécifiez le troisième argument optionnel + <parameter>operator</parameter>, vous pouvez tester une + relation particulière. Les opérateurs possibles sont + <literal><</literal>, + <literal>lt</literal>, <literal><=</literal>, + <literal>le</literal>, <literal>></literal>, + <literal>gt</literal>, <literal>>=</literal>, + <literal>ge</literal>, <literal>==</literal>, + <literal>=</literal>, <literal>eq</literal>, + <literal>!=</literal>, <literal><></literal>, + <literal>ne</literal>. En utilisant cet argument, + <function>version_compare</function> retournera 1 si la + relation est vérifiée et 0 sinon. + </para> + <para> + <example> + <title>Exemple avec <function>version_compare</function></title> + <programlisting role="php"> <?php -require_once("local.php"); -require_once("../inc/global.php"); -for ($i=1; $i<5; $i++) - include "util".$i.".php"; - echo "Fichiers appelés avec required_once/included_once\n"; - print_r(get_required_files()); +echo version_compare("4.0.4", "4.0.6"); +// affiche -1 +echo version_compare("4.0.4", "4.0.6", "<"); +echo version_compare("4.0.6", "4.0.6", "eq"); +// affichent tous 1 ?> - </programlisting> - </example> - va afficher : - <informalexample> - <programlisting> -Fichiers appelés avec required_once/included_once -Array -( - [0] => local.php - [1] => /full/path/to/inc/global.php - [2] => util1.php - [3] => util2.php - [4] => util3.php - [5] => util4.php -) - </programlisting> - </informalexample> - </para> - <note> - <para> - En PHP 4.0.1pl2, cette fonction supposait que - <varname>required_once</varname> utilisait l'extension - ".php" : les autres extensions ne fonctionnaient pas. - Par ailleurs, dans cette version, le tableau retourné était - un tableau associatif, et cette fonction n'était pas - un alias de <function>get_included_files</function> + </programlisting> + </example> </para> - </note> - <para> - Voir aussi - <function>require_once</function>, - <function>include_once</function> et - <function>get_required_files</function>. - </para> - </refsect1> - </refentry> + </refsect1> + </refentry> <refentry id="function.zend-version"> <refnamediv> <refname>zend_version</refname> Index: phpdoc/fr/functions/ingres_ii.xml diff -u phpdoc/fr/functions/ingres_ii.xml:1.8 phpdoc/fr/functions/ingres_ii.xml:1.9 --- phpdoc/fr/functions/ingres_ii.xml:1.8 Wed Aug 8 05:44:39 2001 +++ phpdoc/fr/functions/ingres_ii.xml Wed Nov 14 16:06:23 2001 @@ -1,4 +1,5 @@ -<!-- $Revision: 1.8 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.ingres"> <title>Ingres II</title> <titleabbrev>Ingres II</titleabbrev> @@ -64,7 +65,7 @@ </funcsynopsis> <para> <function>ingres_connect</function> retourne une ressource représentant un - lien Ingres II en cas de succès, et <literal>FALSE</literal> sinon. + lien Ingres II en cas de succès, et &false; sinon. </para> <para> <function>ingres_connect</function> établit une connexion avec la @@ -114,7 +115,8 @@ </programlisting> </example> <para> - Voir aussi <function>ingres_pconnect</function>, et + Voir aussi + <function>ingres_pconnect</function> et <function>ingres_close</function>. </para> </refsect1> @@ -144,7 +146,7 @@ </funcsynopsis> <para> <function>ingres_pconnect</function> retourne une ressource représentant un - lien (link) Ingres II en cas de succès, et <literal>FALSE</literal> sinon. + lien (link) Ingres II en cas de succès, et &false; sinon. </para> <para> Voir <function>ingres_connect</function> pour le détail des paramètres @@ -161,7 +163,9 @@ est dit 'persistant'. </para> <para> - Voir aussi <function>ingres_connect</function> et <function>ingres_close</function>. + Voir aussi + <function>ingres_connect</function> et + <function>ingres_close</function>. </para> </refsect1> </refentry> @@ -181,8 +185,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_close</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> sinon. + <function>ingres_close</function> retourne &true; + en cas de succès, et &false; sinon. </para> <para> <function>ingres_close</function> ferme la connexion au serveur Ingres @@ -197,7 +201,8 @@ script. </para> <para> - Voir aussi <function>ingres_connect</function> et + Voir aussi + <function>ingres_connect</function> et <function>ingres_pconnect</function>. </para> </refsect1> @@ -221,8 +226,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_query</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> sinon. + <function>ingres_query</function> retourne &true; + en cas de succès, et &false; sinon. </para> <para> <function>ingres_query</function> envoie la requête @@ -362,7 +367,7 @@ <simpara> Il faut dans ce cas récupérer les données du résultat en utilisant une de ces 3 fonctions dans une boucle jusqu'à ce qu'elle renvoie - <literal>FALSE</literal>, ce qui indique qu'il n'y a plus de résultats à récupérer. + &false;, ce qui indique qu'il n'y a plus de résultats à récupérer. </simpara> </note> </para> @@ -428,7 +433,7 @@ </funcsynopsis> <para> <function>ingres_field_name</function> retourne le nom d'un champ dans - le résultat d'une requête, ou <literal>FALSE</literal> en cas d'échec. + le résultat d'une requête, ou &false; en cas d'échec. </para> <para> <parameter>index</parameter> est le numéro du champ et doit être compris @@ -465,7 +470,7 @@ </funcsynopsis> <para> <function>ingres_field_type</function> retourne le type d'un champ dans - le résultat d'une requête, ou <literal>FALSE</literal> en cas d'échec. + le résultat d'une requête, ou &false; en cas d'échec. Exemples de types renvoyés par cette fonction : "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Certains de ces types @@ -507,8 +512,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_field_nullable</function> retourne <literal>TRUE</literal> si le champ - peut recevoir la valeur NULL et <literal>FALSE</literal> dans le cas contraire. + <function>ingres_field_nullable</function> retourne &true; si le champ + peut recevoir la valeur NULL et &false; dans le cas contraire. </para> <para> <parameter>index</parameter> est le numéro du champ et doit être compris @@ -656,7 +661,7 @@ </funcsynopsis> <para> <function>ingres_fetch_array</function> renvoie un tableau correspondant - à la ligne récupérée, ou <literal>FALSE</literal> s'il n'y a plus de ligne à récupérer. + à la ligne récupérée, ou &false; s'il n'y a plus de ligne à récupérer. </para> <para> Cette fonction est une version améliorée de @@ -740,14 +745,14 @@ <para> <function>ingres_fetch_row</function> renvoie un tableau correspondant à la ligne récupérée, ou - <literal>FALSE</literal> s'il n'y a plus de ligne à + &false; s'il n'y a plus de ligne à récupérer. La ligne est stockée dans un tableau à indices numériques, le premier champs étant à l'indice 1. </para> <para> Les appels successifs à <function>ingres_fetch_row</function> retournent - les lignes suivantes du résultat, ou <literal>FALSE</literal> s'il n'y a plus de lignes. + les lignes suivantes du résultat, ou &false; s'il n'y a plus de lignes. </para> <para> <example> @@ -794,7 +799,7 @@ <para> <function>ingres_fetch_object</function> renvoie un objet correspondant à la ligne (tuple) récupérée, ou - <literal>FALSE</literal> s'il n'y a plus de ligne à récupérer. + &false; s'il n'y a plus de ligne à récupérer. </para> <para> <function>ingres_fetch_object</function> est similaire à Index: phpdoc/fr/functions/ircg.xml diff -u phpdoc/fr/functions/ircg.xml:1.2 phpdoc/fr/functions/ircg.xml:1.3 --- phpdoc/fr/functions/ircg.xml:1.2 Wed Nov 14 12:52:34 2001 +++ phpdoc/fr/functions/ircg.xml Wed Nov 14 16:06:23 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <reference id="ref.ircg"> <title>IRC</title> <titleabbrev>Interface IRC</titleabbrev> @@ -165,7 +167,7 @@ canal IRC, et sinon, un utilisateur. </para> <para> - En donnant la valeur <literal>TRUE</literal> au paramètre + En donnant la valeur &true; au paramètre <parameter>suppress</parameter>, vous éviterez que vos propres messages soient affichés sur votre connexion <parameter>connection</parameter>. </para> @@ -218,8 +220,8 @@ pris. </para> <para> - <function>ircg_nick</function> retourne <literal>TRUE</literal> en - cas de succès, et <literal>FALSE</literal> + <function>ircg_nick</function> retourne &true; en + cas de succès, et &false; </para> </refsect1> </refentry> @@ -300,7 +302,7 @@ ... </para> <para> - Voir aussi: + Voir aussi </para> </refsect1> </refentry> @@ -323,7 +325,7 @@ <para> </para> <para> - Voir aussi: + Voir aussi </para> </refsect1> </refentry> @@ -377,7 +379,7 @@ </para> <para> Voir aussi - <function>ircg_ignore_del</function> . + <function>ircg_ignore_del</function>. </para> </refsect1> </refentry> @@ -452,9 +454,9 @@ </funcprototype> </funcsynopsis> <para> - <function>ircg_is_conn_alive</function> retourne <literal>TRUE</literal> + <function>ircg_is_conn_alive</function> retourne &true; si la connexion <parameter>connection</parameter> est toujours active - et fonctionnelle, et <literal>FALSE</literal> si la connexion n'est + et fonctionnelle, et &false; si la connexion n'est plus disponible. </para> </refsect1> Index: phpdoc/fr/functions/imap.xml diff -u phpdoc/fr/functions/imap.xml:1.15 phpdoc/fr/functions/imap.xml:1.16 --- phpdoc/fr/functions/imap.xml:1.15 Thu Jul 26 07:00:22 2001 +++ phpdoc/fr/functions/imap.xml Wed Nov 14 16:06:23 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.16 $ --> <reference id="ref.imap"> <title>IMAP</title> <titleabbrev>IMAP</titleabbrev> @@ -164,8 +166,8 @@ aux lettres. </para> <para> - <function>imap_append</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_append</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser @@ -312,7 +314,7 @@ <para> <function>imap_check</function> retourne les informations à propos de la boîte aux lettres courante. - <function>imap_check</function> retourne <literal>FALSE</literal> + <function>imap_check</function> retourne &false; en cas d'échec. </para> <para> @@ -431,8 +433,8 @@ encodés. </para> <para> - <function>imap_createmailbox</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_createmailbox</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> <example> @@ -480,7 +482,8 @@ </example> </para> <para> - Voir aussi <function>imap_renamemailbox</function>, + Voir aussi + <function>imap_renamemailbox</function>, <function>imap_deletemailbox</function> et <function>imap_open</function> pour connaître le format des noms de <parameter>mbox</parameter>. @@ -507,7 +510,7 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_delete</function> retourne <literal>TRUE</literal>. + <function>imap_delete</function> retourne &true;. </para> <para> <function>imap_delete</function> marque le fichier @@ -561,8 +564,8 @@ des noms de <parameter>mbox</parameter>). </para> <para> - <function>imap_deletemailbox</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_deletemailbox</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> Voir aussi @@ -617,7 +620,7 @@ l'effacement par <function>imap_delete</function>. </para> <para> - <function>imap_expunge</function> retourne <literal>TRUE</literal>. + <function>imap_expunge</function> retourne &true;. </para> </refsect1> </refentry> @@ -883,7 +886,7 @@ </row> <row> <entry>ifsubtype</entry> - <entry><literal>TRUE</literal> s'il y a une chaîne de sous type</entry> + <entry>&true; s'il y a une chaîne de sous type</entry> </row> <row> <entry>subtype</entry> @@ -891,7 +894,7 @@ </row> <row> <entry>ifdescription</entry> - <entry><literal>TRUE</literal> s'il y au ne chaîne de description</entry> + <entry>&true; s'il y au ne chaîne de description</entry> </row> <row> <entry>description</entry> @@ -899,7 +902,7 @@ </row> <row> <entry>ifid</entry> - <entry><literal>TRUE</literal> s'il y a une chaîne d'identification</entry> + <entry>&true; s'il y a une chaîne d'identification</entry> </row> <row> <entry>id</entry> @@ -915,7 +918,7 @@ </row> <row> <entry>ifdisposition</entry> - <entry><literal>TRUE</literal> s'il y a une chaîne de disposition</entry> + <entry>&true; s'il y a une chaîne de disposition</entry> </row> <row> <entry>disposition</entry> @@ -924,7 +927,7 @@ <row> <entry>ifdparameters</entry> <entry> - <literal>TRUE</literal> s'il y a un tableau de paramètres dparameters + &true; s'il y a un tableau de paramètres dparameters </entry> </row> <row> @@ -933,7 +936,7 @@ </row> <row> <entry>ifparameters</entry> - <entry><literal>TRUE</literal> si le tableau de paramètres existe</entry> + <entry>&true; si le tableau de paramètres existe</entry> </row> <row> <entry>parameters</entry> @@ -1030,7 +1033,7 @@ <parameter>quota_root</parameter>. Le quota représente la taille maximale de votre boîte aux lettres. La valeur courante est l'espace actuellement utilisé par votre boîte aux lettres. - <function>imap_get_quota</function> retournera <literal>FALSE</literal> + <function>imap_get_quota</function> retournera &false; en cas d'échec. </para> <para> @@ -1165,7 +1168,8 @@ </example> </para> <para> - Voir aussi <function>imap_getsubscribed</function>. + Voir aussi + <function>imap_getsubscribed</function>. </para> </refsect1> </refentry> @@ -1542,8 +1546,8 @@ une liste numéros de message. </para> <para> - <function>imap_mail_copy</function> retourne <literal>TRUE</literal> - en cas de succès et <literal>FALSE</literal> en cas d'erreur. + <function>imap_mail_copy</function> retourne &true; + en cas de succès et &false; en cas d'erreur. </para> <para> <parameter>flags</parameter> est un masque, qui peut contenir une ou plusieurs @@ -1603,8 +1607,8 @@ </itemizedlist> </para> <para> - <function>imap_mail_move</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_mail_move</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -1626,7 +1630,7 @@ <para> <function>imap_mailboxmsginfo</function> retourne les informations à propos de la boîte aux lettres courante. <function>imap_mailboxmsginfo</function> - retourne <literal>FALSE</literal> en cas d'échec. + retourne &false; en cas d'échec. </para> <para> <function>imap_mailboxmsginfo</function> vérifie le statut courant de @@ -1843,7 +1847,7 @@ </funcsynopsis> <para> <function>imap_open</function> retourne un flot <acronym>IMAP</acronym> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + en cas de succès, et &false; en cas d'erreur. <function>imap_open</function> peut aussi être utilisée pour ouvrir des flots sur des serveurs <acronym>POP3</acronym> et <acronym>NNTP</acronym>. </para> @@ -1944,7 +1948,7 @@ $mbox = imap_open ("{votre.hote.imap:143}", "nom_utilisateur", "mot de passe"); echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{votre.hote.imap:143}", "*"); -if ($folders == <literal>FALSE</literal>) { +if ($folders == &false;) { echo "Appel échoué<br>\n"; } else { while (list ($key, $val) = each ($folders)) { @@ -1953,7 +1957,7 @@ } echo "<p><h1>en-têtes dans INBOX</h1>\n"; $headers = imap_headers ($mbox); -if ($headers == <literal>FALSE</literal>) { +if ($headers == &false;) { echo "Appel échoué<br>\n"; } else { while (list ($key,$val) = each ($headers)) { @@ -1981,9 +1985,9 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_ping</function> retourne <literal>TRUE</literal> si + <function>imap_ping</function> retourne &true; si le flot <parameter>imap_stream</parameter> existe toujours, - et <literal>FALSE</literal> sinon. + et &false; sinon. </para> <para> <function>imap_ping</function> vérifie que le flot <acronym>IMAP</acronym> @@ -2046,11 +2050,12 @@ <parameter>old_mbox</parameter> en <parameter>new_mbox</parameter>. </para> <para> - <function>imap_renamemailbox</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_renamemailbox</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> <para> - Voir aussi <function>imap_createmailbox</function>, + Voir aussi + <function>imap_createmailbox</function>, <function>imap_deletemailbox</function> et <function>imap_open</function> pour le format de <parameter>mbox</parameter>. </para> @@ -2469,8 +2474,8 @@ maximum (en ko) de la boîte <parameter>quota_root</parameter>. </para> <para> - <function>imap_set_quota</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> sinon. + <function>imap_set_quota</function> retourne &true; + en cas de succès, et &false; sinon. </para> <para> <example> @@ -2488,7 +2493,8 @@ </example> </para> <para> - Voir aussi <function>imap_open</function> et + Voir aussi + <function>imap_open</function> et <function>imap_set_quota</function>. </para> </refsect1> @@ -2702,8 +2708,8 @@ lettres <parameter>mbox</parameter>. </para> <para> - <function>imap_subscribe</function> retourne <literal>TRUE</literal> en cas de - succès, et <literal>FALSE</literal> en cas d'échec. + <function>imap_subscribe</function> retourne &true; en cas de + succès, et &false; en cas d'échec. </para> </refsect1> </refentry> @@ -2761,8 +2767,8 @@ <function>imap_delete</function>. </para> <para> - <function>imap_subscribe</function> retourne <literal>TRUE</literal> en cas - de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_subscribe</function> retourne &true; en cas + de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -2787,8 +2793,8 @@ la boîte aux lettres <parameter>mbox</parameter>. </para> <para> - <function>imap_unsubscribe</function> retourne <literal>TRUE</literal> - en cas de succès, et <literal>FALSE</literal> en cas d'erreur. + <function>imap_unsubscribe</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> @@ -2813,7 +2819,7 @@ </para> <para> <function>imap_utf7_decode</function> retourne les données - 8bits décodées, ou <literal>FALSE</literal> si la chaîne + 8bits décodées, ou &false; si la chaîne <parameter>text</parameter> n'est pas au format UTF-7. Cette fonction sert à décoder des noms de boîtes aux lettres qui contiennent des caractères internationaux hors de l'espace ASCII. Le standard @@ -2841,7 +2847,7 @@ </funcsynopsis> <para> <function>imap_utf7_encode</function> retourne les données - <parameter>data</parameter> 8bits encodées, ou <literal>FALSE</literal> + <parameter>data</parameter> 8bits encodées, ou &false; si une erreur est survenue. Cette fonction sert à encoder des noms de boîtes aux lettres qui contiennent des caractères internationaux