cvs: phpdoc /fr/functions misc.xml
| From: | Damien Seguy | Date: | Wed, 11 Jul 2001 09:24:03 +0000 |
| Subject: | cvs: phpdoc /fr/functions misc.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336126@lists.php.net to get a copy of this message | ||
dams Wed Jul 11 05:24:03 2001 EDT
Modified files:
/phpdoc/fr/functions misc.xml
Log:
added constant()
Index: phpdoc/fr/functions/misc.xml diff -u phpdoc/fr/functions/misc.xml:1.9 phpdoc/fr/functions/misc.xml:1.10 --- phpdoc/fr/functions/misc.xml:1.9 Sat Jul 7 18:22:15 2001 +++ phpdoc/fr/functions/misc.xml Wed Jul 11 05:24:02 2001 @@ -15,12 +15,14 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>connection_aborted</function></funcdef> <paramdef>void <parameter></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>connection_aborted</function> retourne &true; si le client a abandonné - la connexion. Reportez vous à + <function>connection_aborted</function> retourne &true; + si le client a abandonné la connexion. Reportez-vous à <link linkend="features.connection-handling">Gestion des connexions</link> du chapitre <link linkend="features">Caractéristiques</link>. </simpara> @@ -34,12 +36,14 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>connection_status</function></funcdef> <paramdef>void <parameter></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>connection_status</function> retourne les bits de status de la connexion. - Reportez vous à la section + <function>connection_status</function> retourne les bits de statut de la connexion. + Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> pour plus de détails. </simpara> @@ -48,17 +52,19 @@ <refentry id="function.connection-timeout"> <refnamediv> <refname>connection_timeout</refname> - <refpurpose>Retourne &true; si le script a éxpiré.</refpurpose> + <refpurpose>Indique si le script a expiré.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>connection_timeout</function></funcdef> + <funcprototype> + <funcdef>bool <function>connection_timeout</function></funcdef> <paramdef>void <parameter></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>connection_timeout</function> retourne &true; si le script a éxpiré. - Reportez vous à la section + <function>connection_timeout</function> retourne &true; + si le script a expiré. Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> pour plus de détails. </simpara> @@ -72,12 +78,14 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>define</function></funcdef> <paramdef>string <parameter>name</parameter></paramdef> <paramdef>mixed <parameter>value</parameter></paramdef> <paramdef>int <parameter><optional>case_insensitive</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <para> <function>define</function> définit une constante, de la même @@ -108,25 +116,27 @@ </itemizedlist> </para> <para> - Le nom de la constante est donnée par le paramètre + Le nom de la constante est donné par le paramètre <parameter>name</parameter>; sa valeur est donnée par <parameter>value</parameter>. </para> <para> Le troisième paramètre optionnel - <parameter>case_insensitive</parameter> peut prendre la valeur de - <emphasis>1</emphasis>. Dans ce cas, le nom de la constante - sera insensible à la casse (c'est la valeur par défaut). - Cela signifie que, par défaut, CONSTANT et Constant - représentent des valeurs différentes. + <parameter>case_insensitive</parameter> est une valeur booléenne. + S'il vaut <literal>TRUE</literal>, + le nom de la constante sera insensible à la casse : + <literal>CONSTANT</literal> et <literal>Constant</literal> + représentent des valeurs identiques. Par défaut, + ces constantes représenteront des valeurs différentes. </para> <para> <example> <title>Définition d'une constante</title> <programlisting role="php"> <?php -define ("CONSTANT", "Bonjour le monde."); -echo CONSTANT; // affiche "Bonjour le monde." +define("CONSTANTE", "Bonjour le monde."); +echo CONSTANTE; +// affiche "Bonjour le monde." ?> </programlisting> </example> @@ -135,7 +145,51 @@ <function>define</function> retoune &true; en cas de succès et &false; sinon. </para> <para> - Voir aussi <function>defined</function> et la section sur les + Voir aussi + <function>defined</function> et la section sur les + <link linkend="language.constants">constantes</link>. + </para> + </refsect1> + </refentry> + <refentry id="function.constant"> + <refnamediv> + <refname>constant</refname> + <refpurpose>Retourne la valeur d'une constante</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>constant</function></funcdef> + <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>constant</function> retourne la valeur de la constante + <parameter>name</parameter>. + </simpara> + <simpara> + <function>constant</function> est pratique lorsque vous devez lire la + valeur d'une constante, mais que vous ne savez son nom que durant + l'excution du script. Par exemple, ce nom peut tre le rsultat + d'une fonction. + </simpara> + <para> + <example> + <title>Exempe avec <function>constant</function></title> + <programlisting role="php"> +<php + define ("MAXSIZE", 100); + echo MAXSIZE; + echo constant("MAXSIZE"); // same thing as the previous line +?> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>define</function>, + <function>defined</function> et la section sur les <link linkend="language.constants">constantes</link>. </para> </refsect1> @@ -150,8 +204,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>defined</function></funcdef> <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>defined</function> retourne &true; si la constante nommée @@ -159,7 +215,8 @@ et &false; sinon. </para> <para> - Voir aussi <function>define</function> et la section sur les + Voir aussi + <function>define</function> et la section sur les <link linkend="language.constants">constantes</link>. </para> </refsect1> @@ -174,8 +231,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>die</function></funcdef> <paramdef>string <parameter>message</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>die</function> affiche la chaîne passée @@ -204,8 +263,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>eval</function></funcdef> <paramdef>string <parameter>code_str</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>eval</function> évalue la chaîne @@ -231,7 +292,7 @@ <programlisting role="php"> <?php $string = 'tasse'; -$name = 'cafe'; +$name = 'café'; $str = 'Ceci est une $string avec mon $name dedans.<br>'; echo $str; eval( "\$str = \"$str\";" ); @@ -241,10 +302,10 @@ </example> </para> <para> - L'exemple ci dessus devrait afficher : + L'exemple ci-dessus devrait afficher : <computeroutput> Ceci est une $string avec mon $name dedans. -Ceci est une tasse avec mon cafe dedans. +Ceci est une tasse avec mon café dedans. </computeroutput> </para> </refsect1> @@ -257,12 +318,15 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>exit</function></funcdef> - <paramdef>void</paramdef> + <paramdef>mixed <parameter>status</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>exit</function> termine l'analyse d'un script en cours - d'exécution. Elle ne renvoie aucune valeur. + <function>exit</function> termine l'éxécution du script courant. + Elle n'a pas de valeur de retour (et pour cause!), mais elle utilisera + le message <parameter>status</parameter> comme message de fin d'exécution. </simpara> </refsect1> </refentry> @@ -276,10 +340,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>object <function>get_browser</function></funcdef> <paramdef>string <parameter><optional>user_agent</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>get_browser</function> essaie de déterminer les @@ -356,14 +422,14 @@ doit mener au fichier <filename>browscap.ini</filename>. </simpara> <simpara> - Pour plus d'informations, (y compris pour les endroits oú + Pour plus d'informations, (y compris pour les endroits où charger le fichier <filename>browscap.ini</filename>), suivez la FAQ PHP à <ulink url="&url.php.faq;">http://www.php.net/FAQ.html</ulink>. </simpara> <note> <simpara> - Browscap a été ajouté dans PHP version 3.0b2. + Browscap a été ajouté en PHP 3.0b2. </simpara> </note> </refsect1> @@ -377,7 +443,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>highlight_file</function></funcdef> + <funcdef>boolean <function>highlight_file</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -392,7 +458,7 @@ <simpara> Pour configurer une URL qui peut coloriser n'importe quel script que vous lui passez, nous avons besoin d'utiliser la directive - Apache "ForceType", pour généer une URL + Apache "ForceType", pour générer une URL exploitable, puis utiliser la fonction <function>highlight_file</function> pour afficher un code propre. </simpara> @@ -439,7 +505,7 @@ </programlisting> </para> <simpara> - Alors, vous pourrez utiliser une URL telle que celle ci dessous pour afficher + Alors, vous pourrez utiliser une URL telle que celle ci-dessous pour afficher une version colorisée de votre script "/path/to/script.php". </simpara> <para> @@ -452,7 +518,8 @@ </example> </para> <simpara> - Voir aussi <function>highlight_string</function>, + Voir aussi + <function>highlight_string</function> et <function>show_source</function>. </simpara> </refsect1> @@ -476,7 +543,9 @@ définies dans le moteur interne de PHP. </simpara> <simpara> - Voir aussi <function>highlight_file</function>, <function>show_source</function>. + Voir aussi + <function>highlight_file</function> et + <function>show_source</function>. </simpara> </refsect1> </refentry> @@ -491,10 +560,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>ignore_user_abort</function></funcdef> <paramdef>int <parameter><optional>setting</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>ignore_user_abort</function> active l'option décidant si, lors de @@ -519,15 +590,21 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>iptcparse</function></funcdef> <paramdef>string <parameter>iptcblock</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>iptcparse</function> analyse un bloc binaire IPTC et recherche les balises simples. <function>iptcparse</function> retourne un tableau avec - les balises comme index et les valeurs dans les valeurs de tableau + les balises comme index et les valeurs de ces balises IPTC dans les valeurs de tableau correspondantes. En cas d'erreur, ou si aucune balise IPTC n'a été - trouvée, retourne &false;. Voir <function>getimagesize</function> pour un exemple. + trouvée, retourne &false;. + <simpara> + </simpara> + Voir + <function>getimagesize</function> pour un exemple. </simpara> </refsect1> </refentry> @@ -539,8 +616,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>leak</function></funcdef> <paramdef>int <parameter>bytes</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>leak</function> crée une fuite de mémoire. @@ -560,11 +639,13 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>pack</function></funcdef> <paramdef>string <parameter>format</parameter></paramdef> <paramdef>mixed - <parameter><optional>args</optional></parameter> ... + <parameter><optional>args</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <para> <function>pack</function> compacte les arguments dans une chaîne binaire, @@ -573,14 +654,14 @@ </para> <para> L'idée vient du Perl et tout le formatage fonctionne de - la même fonction qu'en Perl, mais quelques formats manquent + la même façon qu'en Perl, mais quelques formats manquent encore (comme, "u" ). La chaîne de format est composée - d'une série de code de formats, suivis par un quantificateur + d'une série de codes de formats, suivis par un quantificateur optionnel. Le quantificateur peut être un entier, ou * pour la répétition indéfinie. Pour les formats a, A, h et H, le quantificateur spécifie combien de - caractères d'un argument sont pris; pour @, c'est - la position absolue oú placer les données, + caractères d'un argument sont pris; pour @, c'est + la position absolue où placer les données, et pour le reste, c'est le nombre de répétitions. Actuellement, les formats suivants sont implémentés : <itemizedlist> @@ -686,7 +767,7 @@ </listitem> <listitem> <simpara> - @ rempli avec &null;, jusqu'à une position absolue + @ rempli avec &null;, jusqu'à une position absolue </simpara> </listitem> </itemizedlist> @@ -694,7 +775,7 @@ <title>Compactage d'une chaîne</title> <programlisting role="php"> <?php -$binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66); + $binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66); ?> </programlisting> <para> @@ -742,7 +823,8 @@ </simpara> </note> <simpara> - Voir aussi <function>highlight_string</function>, + Voir aussi + <function>highlight_string</function> et <function>highlight_file</function>. </simpara> </refsect1> @@ -755,31 +837,36 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>sleep</function></funcdef> <paramdef>int <parameter>seconds</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>sleep</function> retarde l'exécution du programme pendant <parameter>seconds</parameter> secondes. </simpara> <simpara> - Voir aussi <function>usleep</function>. + Voir aussi + <function>usleep</function>. </simpara> </refsect1> </refentry> <refentry id="function.uniqid"> <refnamediv> <refname>uniqid</refname> - <refpurpose>Génére un identifiant unique.</refpurpose> + <refpurpose>Génère un identifiant unique.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>uniqid</function></funcdef> <paramdef>string <parameter>prefix</parameter></paramdef> <paramdef>boolean <parameter><optional>lcg</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>uniqid</function> retourne un identifiant @@ -812,7 +899,7 @@ <para> Si vous voulez utiliser un identifiant unique, ou bien gérer des cookies, il est recommandé d'utiliser un code - tel que celui ci : + tel que celui-ci : <informalexample> <programlisting role="php"> <?php @@ -823,7 +910,7 @@ </informalexample> </para> <simpara> - Ceci va créer un identifiant de 32 caractère + Ceci va créer un identifiant de 32 caractères (un nombre hexadécimal de 128 ) qui sera très difficile à prédire. </simpara> @@ -839,14 +926,16 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>unpack</function></funcdef> <paramdef>string <parameter>format</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>unpack</function> déconditionne des données depuis une chaîne binaire avec le format - <parameter>format</parameter>. Retourne un tableau contenant + <parameter>format</parameter>. <function>unpack</function> retourne un tableau contenant les éléments déconditionnés. </para> <para> @@ -869,7 +958,7 @@ </example> </para> <para> - Pour plus de détails, reportez vous à: + Pour plus de détails, reportez-vous à: <function>pack</function> </para> <para> @@ -877,7 +966,7 @@ sous forme signée. Si vous déconditionnez une valeur qui est aussi grande que la taille utilisée en interne par PHP, le résultat se trouvera être - un nombre négatif, même si il a été + un nombre négatif, même s'il a été déconditionné avec l'option " non signé ". </para> </refsect1> @@ -890,15 +979,18 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>usleep</function></funcdef> <paramdef>int <parameter>micro_seconds</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>sleep</function> retarde l'exécution du programme pendant <parameter>micro_seconds</parameter> micro-secondes. </simpara> <simpara> - Voir aussi <function>sleep</function>. + Voir aussi + <function>sleep</function>. </simpara> <note> <simpara>
Index: phpdoc/fr/functions/misc.xml diff -u phpdoc/fr/functions/misc.xml:1.9 phpdoc/fr/functions/misc.xml:1.10 --- phpdoc/fr/functions/misc.xml:1.9 Sat Jul 7 18:22:15 2001 +++ phpdoc/fr/functions/misc.xml Wed Jul 11 05:24:02 2001 @@ -15,12 +15,14 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>connection_aborted</function></funcdef> <paramdef>void <parameter></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>connection_aborted</function> retourne &true; si le client a abandonné - la connexion. Reportez vous à + <function>connection_aborted</function> retourne &true; + si le client a abandonné la connexion. Reportez-vous à <link linkend="features.connection-handling">Gestion des connexions</link> du chapitre <link linkend="features">Caractéristiques</link>. </simpara> @@ -34,12 +36,14 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>connection_status</function></funcdef> <paramdef>void <parameter></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>connection_status</function> retourne les bits de status de la connexion. - Reportez vous à la section + <function>connection_status</function> retourne les bits de statut de la connexion. + Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> pour plus de détails. </simpara> @@ -48,17 +52,19 @@ <refentry id="function.connection-timeout"> <refnamediv> <refname>connection_timeout</refname> - <refpurpose>Retourne &true; si le script a éxpiré.</refpurpose> + <refpurpose>Indique si le script a expiré.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>connection_timeout</function></funcdef> + <funcprototype> + <funcdef>bool <function>connection_timeout</function></funcdef> <paramdef>void <parameter></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>connection_timeout</function> retourne &true; si le script a éxpiré. - Reportez vous à la section + <function>connection_timeout</function> retourne &true; + si le script a expiré. Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> pour plus de détails. </simpara> @@ -72,12 +78,14 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>define</function></funcdef> <paramdef>string <parameter>name</parameter></paramdef> <paramdef>mixed <parameter>value</parameter></paramdef> <paramdef>int <parameter><optional>case_insensitive</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <para> <function>define</function> définit une constante, de la même @@ -108,25 +116,27 @@ </itemizedlist> </para> <para> - Le nom de la constante est donnée par le paramètre + Le nom de la constante est donné par le paramètre <parameter>name</parameter>; sa valeur est donnée par <parameter>value</parameter>. </para> <para> Le troisième paramètre optionnel - <parameter>case_insensitive</parameter> peut prendre la valeur de - <emphasis>1</emphasis>. Dans ce cas, le nom de la constante - sera insensible à la casse (c'est la valeur par défaut). - Cela signifie que, par défaut, CONSTANT et Constant - représentent des valeurs différentes. + <parameter>case_insensitive</parameter> est une valeur booléenne. + S'il vaut <literal>TRUE</literal>, + le nom de la constante sera insensible à la casse : + <literal>CONSTANT</literal> et <literal>Constant</literal> + représentent des valeurs identiques. Par défaut, + ces constantes représenteront des valeurs différentes. </para> <para> <example> <title>Définition d'une constante</title> <programlisting role="php"> <?php -define ("CONSTANT", "Bonjour le monde."); -echo CONSTANT; // affiche "Bonjour le monde." +define("CONSTANTE", "Bonjour le monde."); +echo CONSTANTE; +// affiche "Bonjour le monde." ?> </programlisting> </example> @@ -135,7 +145,51 @@ <function>define</function> retoune &true; en cas de succès et &false; sinon. </para> <para> - Voir aussi <function>defined</function> et la section sur les + Voir aussi + <function>defined</function> et la section sur les + <link linkend="language.constants">constantes</link>. + </para> + </refsect1> + </refentry> + <refentry id="function.constant"> + <refnamediv> + <refname>constant</refname> + <refpurpose>Retourne la valeur d'une constante</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>constant</function></funcdef> + <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>constant</function> retourne la valeur de la constante + <parameter>name</parameter>. + </simpara> + <simpara> + <function>constant</function> est pratique lorsque vous devez lire la + valeur d'une constante, mais que vous ne savez son nom que durant + l'excution du script. Par exemple, ce nom peut tre le rsultat + d'une fonction. + </simpara> + <para> + <example> + <title>Exempe avec <function>constant</function></title> + <programlisting role="php"> +<php + define ("MAXSIZE", 100); + echo MAXSIZE; + echo constant("MAXSIZE"); // same thing as the previous line +?> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>define</function>, + <function>defined</function> et la section sur les <link linkend="language.constants">constantes</link>. </para> </refsect1> @@ -150,8 +204,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>defined</function></funcdef> <paramdef>string <parameter>name</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>defined</function> retourne &true; si la constante nommée @@ -159,7 +215,8 @@ et &false; sinon. </para> <para> - Voir aussi <function>define</function> et la section sur les + Voir aussi + <function>define</function> et la section sur les <link linkend="language.constants">constantes</link>. </para> </refsect1> @@ -174,8 +231,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>die</function></funcdef> <paramdef>string <parameter>message</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>die</function> affiche la chaîne passée @@ -204,8 +263,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>eval</function></funcdef> <paramdef>string <parameter>code_str</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>eval</function> évalue la chaîne @@ -231,7 +292,7 @@ <programlisting role="php"> <?php $string = 'tasse'; -$name = 'cafe'; +$name = 'café'; $str = 'Ceci est une $string avec mon $name dedans.<br>'; echo $str; eval( "\$str = \"$str\";" ); @@ -241,10 +302,10 @@ </example> </para> <para> - L'exemple ci dessus devrait afficher : + L'exemple ci-dessus devrait afficher : <computeroutput> Ceci est une $string avec mon $name dedans. -Ceci est une tasse avec mon cafe dedans. +Ceci est une tasse avec mon café dedans. </computeroutput> </para> </refsect1> @@ -257,12 +318,15 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>exit</function></funcdef> - <paramdef>void</paramdef> + <paramdef>mixed <parameter>status</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> - <function>exit</function> termine l'analyse d'un script en cours - d'exécution. Elle ne renvoie aucune valeur. + <function>exit</function> termine l'éxécution du script courant. + Elle n'a pas de valeur de retour (et pour cause!), mais elle utilisera + le message <parameter>status</parameter> comme message de fin d'exécution. </simpara> </refsect1> </refentry> @@ -276,10 +340,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>object <function>get_browser</function></funcdef> <paramdef>string <parameter><optional>user_agent</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>get_browser</function> essaie de déterminer les @@ -356,14 +422,14 @@ doit mener au fichier <filename>browscap.ini</filename>. </simpara> <simpara> - Pour plus d'informations, (y compris pour les endroits oú + Pour plus d'informations, (y compris pour les endroits où charger le fichier <filename>browscap.ini</filename>), suivez la FAQ PHP à <ulink url="&url.php.faq;">http://www.php.net/FAQ.html</ulink>. </simpara> <note> <simpara> - Browscap a été ajouté dans PHP version 3.0b2. + Browscap a été ajouté en PHP 3.0b2. </simpara> </note> </refsect1> @@ -377,7 +443,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>highlight_file</function></funcdef> + <funcdef>boolean <function>highlight_file</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -392,7 +458,7 @@ <simpara> Pour configurer une URL qui peut coloriser n'importe quel script que vous lui passez, nous avons besoin d'utiliser la directive - Apache "ForceType", pour généer une URL + Apache "ForceType", pour générer une URL exploitable, puis utiliser la fonction <function>highlight_file</function> pour afficher un code propre. </simpara> @@ -439,7 +505,7 @@ </programlisting> </para> <simpara> - Alors, vous pourrez utiliser une URL telle que celle ci dessous pour afficher + Alors, vous pourrez utiliser une URL telle que celle ci-dessous pour afficher une version colorisée de votre script "/path/to/script.php". </simpara> <para> @@ -452,7 +518,8 @@ </example> </para> <simpara> - Voir aussi <function>highlight_string</function>, + Voir aussi + <function>highlight_string</function> et <function>show_source</function>. </simpara> </refsect1> @@ -476,7 +543,9 @@ définies dans le moteur interne de PHP. </simpara> <simpara> - Voir aussi <function>highlight_file</function>, <function>show_source</function>. + Voir aussi + <function>highlight_file</function> et + <function>show_source</function>. </simpara> </refsect1> </refentry> @@ -491,10 +560,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>ignore_user_abort</function></funcdef> <paramdef>int <parameter><optional>setting</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>ignore_user_abort</function> active l'option décidant si, lors de @@ -519,15 +590,21 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>iptcparse</function></funcdef> <paramdef>string <parameter>iptcblock</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>iptcparse</function> analyse un bloc binaire IPTC et recherche les balises simples. <function>iptcparse</function> retourne un tableau avec - les balises comme index et les valeurs dans les valeurs de tableau + les balises comme index et les valeurs de ces balises IPTC dans les valeurs de tableau correspondantes. En cas d'erreur, ou si aucune balise IPTC n'a été - trouvée, retourne &false;. Voir <function>getimagesize</function> pour un exemple. + trouvée, retourne &false;. + <simpara> + </simpara> + Voir + <function>getimagesize</function> pour un exemple. </simpara> </refsect1> </refentry> @@ -539,8 +616,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>leak</function></funcdef> <paramdef>int <parameter>bytes</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>leak</function> crée une fuite de mémoire. @@ -560,11 +639,13 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>pack</function></funcdef> <paramdef>string <parameter>format</parameter></paramdef> <paramdef>mixed - <parameter><optional>args</optional></parameter> ... + <parameter><optional>args</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <para> <function>pack</function> compacte les arguments dans une chaîne binaire, @@ -573,14 +654,14 @@ </para> <para> L'idée vient du Perl et tout le formatage fonctionne de - la même fonction qu'en Perl, mais quelques formats manquent + la même façon qu'en Perl, mais quelques formats manquent encore (comme, "u" ). La chaîne de format est composée - d'une série de code de formats, suivis par un quantificateur + d'une série de codes de formats, suivis par un quantificateur optionnel. Le quantificateur peut être un entier, ou * pour la répétition indéfinie. Pour les formats a, A, h et H, le quantificateur spécifie combien de - caractères d'un argument sont pris; pour @, c'est - la position absolue oú placer les données, + caractères d'un argument sont pris; pour @, c'est + la position absolue où placer les données, et pour le reste, c'est le nombre de répétitions. Actuellement, les formats suivants sont implémentés : <itemizedlist> @@ -686,7 +767,7 @@ </listitem> <listitem> <simpara> - @ rempli avec &null;, jusqu'à une position absolue + @ rempli avec &null;, jusqu'à une position absolue </simpara> </listitem> </itemizedlist> @@ -694,7 +775,7 @@ <title>Compactage d'une chaîne</title> <programlisting role="php"> <?php -$binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66); + $binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66); ?> </programlisting> <para> @@ -742,7 +823,8 @@ </simpara> </note> <simpara> - Voir aussi <function>highlight_string</function>, + Voir aussi + <function>highlight_string</function> et <function>highlight_file</function>. </simpara> </refsect1> @@ -755,31 +837,36 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>sleep</function></funcdef> <paramdef>int <parameter>seconds</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>sleep</function> retarde l'exécution du programme pendant <parameter>seconds</parameter> secondes. </simpara> <simpara> - Voir aussi <function>usleep</function>. + Voir aussi + <function>usleep</function>. </simpara> </refsect1> </refentry> <refentry id="function.uniqid"> <refnamediv> <refname>uniqid</refname> - <refpurpose>Génére un identifiant unique.</refpurpose> + <refpurpose>Génère un identifiant unique.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>uniqid</function></funcdef> <paramdef>string <parameter>prefix</parameter></paramdef> <paramdef>boolean <parameter><optional>lcg</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>uniqid</function> retourne un identifiant @@ -812,7 +899,7 @@ <para> Si vous voulez utiliser un identifiant unique, ou bien gérer des cookies, il est recommandé d'utiliser un code - tel que celui ci : + tel que celui-ci : <informalexample> <programlisting role="php"> <?php @@ -823,7 +910,7 @@ </informalexample> </para> <simpara> - Ceci va créer un identifiant de 32 caractère + Ceci va créer un identifiant de 32 caractères (un nombre hexadécimal de 128 ) qui sera très difficile à prédire. </simpara> @@ -839,14 +926,16 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>unpack</function></funcdef> <paramdef>string <parameter>format</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>unpack</function> déconditionne des données depuis une chaîne binaire avec le format - <parameter>format</parameter>. Retourne un tableau contenant + <parameter>format</parameter>. <function>unpack</function> retourne un tableau contenant les éléments déconditionnés. </para> <para> @@ -869,7 +958,7 @@ </example> </para> <para> - Pour plus de détails, reportez vous à: + Pour plus de détails, reportez-vous à: <function>pack</function> </para> <para> @@ -877,7 +966,7 @@ sous forme signée. Si vous déconditionnez une valeur qui est aussi grande que la taille utilisée en interne par PHP, le résultat se trouvera être - un nombre négatif, même si il a été + un nombre négatif, même s'il a été déconditionné avec l'option " non signé ". </para> </refsect1> @@ -890,15 +979,18 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>void <function>usleep</function></funcdef> <paramdef>int <parameter>micro_seconds</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>sleep</function> retarde l'exécution du programme pendant <parameter>micro_seconds</parameter> micro-secondes. </simpara> <simpara> - Voir aussi <function>sleep</function>. + Voir aussi + <function>sleep</function>. </simpara> <note> <simpara>