[PHP-DOC] cvs: phpdoc /fr/functions misc.xml

[Damien Seguy]

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&eacute;
-     la connexion. Reportez vous &agrave;
+     <function>connection_aborted</function> retourne &true;
+     si le client a abandonn&eacute; la connexion. Reportez-vous &agrave;
      <link linkend="features.connection-handling">Gestion des connexions</link>
      du chapitre <link linkend="features">Caract&eacute;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 &agrave; la section
+     <function>connection_status</function> retourne les bits de statut de la 
+connexion.
+     Reportez-vous &agrave; la section
      <link linkend="features.connection-handling">gestion des connexions</link>
      pour plus de d&eacute;tails.
     </simpara>
@@ -48,17 +52,19 @@
   <refentry id="function.connection-timeout">
    <refnamediv>
     <refname>connection_timeout</refname>
-    <refpurpose>Retourne &true; si le script a &eacute;xpir&eacute;.</refpurpose>
+    <refpurpose>Indique si le script a expir&eacute;.</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 
&eacute;xpir&eacute;.
-     Reportez vous &agrave; la section
+     <function>connection_timeout</function> retourne &true;
+     si le script a expir&eacute;. Reportez-vous &agrave; la section
      <link linkend="features.connection-handling">gestion des connexions</link>
      pour plus de d&eacute;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&eacute;finit une constante, de la m&ecirc;me
@@ -108,25 +116,27 @@
      </itemizedlist>
     </para>
     <para>
-      Le nom de la constante est donn&eacute;e par le param&egrave;tre
+      Le nom de la constante est donn&eacute; par le param&egrave;tre
       <parameter>name</parameter>; sa valeur est donn&eacute;e par
       <parameter>value</parameter>.
     </para>
     <para>
      Le troisi&egrave;me param&egrave;tre optionnel
-     <parameter>case_insensitive</parameter> peut prendre la valeur de
-     <emphasis>1</emphasis>. Dans ce cas, le nom de la constante
-     sera insensible &agrave; la casse (c'est la valeur par d&eacute;faut).
-     Cela signifie que, par d&eacute;faut, CONSTANT et Constant
-     repr&eacute;sentent des valeurs diff&eacute;rentes.
+     <parameter>case_insensitive</parameter> est une valeur bool&eacute;enne.
+     S'il vaut <literal>TRUE</literal>,
+     le nom de la constante sera insensible &agrave; la casse :
+     <literal>CONSTANT</literal> et <literal>Constant</literal>
+     repr&eacute;sentent des valeurs identiques. Par d&eacute;faut,
+     ces constantes repr&eacute;senteront des valeurs diff&eacute;rentes.
     </para>
     <para>
      <example>
       <title>D&eacute;finition d'une constante</title>
       <programlisting role="php">
 &lt;?php
-define ("CONSTANT", "Bonjour le monde.");
-echo CONSTANT; // affiche "Bonjour le monde."
+define("CONSTANTE", "Bonjour le monde.");
+echo CONSTANTE;
+// affiche "Bonjour le monde."
 ?&gt;
       </programlisting>
      </example>
@@ -135,7 +145,51 @@
       <function>define</function> retoune &true; en cas de succ&egrave;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'ex�cution du script. Par exemple, ce nom peut �tre le r�sultat
+     d'une fonction.
+    </simpara>
+    <para>
+     <example>
+      <title>Exempe avec <function>constant</function></title>
+      <programlisting role="php">
+&lt;php
+  define ("MAXSIZE", 100);
+  echo MAXSIZE;
+  echo constant("MAXSIZE"); // same thing as the previous line
+?&gt;
+      </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&eacute;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&icirc;ne pass&eacute;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> &eacute;value la cha&icirc;ne
@@ -231,7 +292,7 @@
       <programlisting role="php">
 &lt;?php
 $string = 'tasse';
-$name = 'cafe';
+$name = 'caf&eacute;';
 $str = 'Ceci est une $string avec mon $name dedans.&lt;br&gt;';
 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&eacute; 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&eacute;cution. Elle ne renvoie aucune valeur.
+     <function>exit</function> termine l'&eacute;x&eacute;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&eacute;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&eacute;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&uacute;
+     Pour plus d'informations, (y compris pour les endroits o&ugrave;
      charger le fichier
      <filename>browscap.ini</filename>), suivez la FAQ PHP &agrave;
      <ulink url="&url.php.faq;">http://www.php.net/FAQ.html</ulink>.
     </simpara>
     <note>
      <simpara>
-      Browscap a &eacute;t&eacute; ajout&eacute; dans PHP version 3.0b2.
+      Browscap a &eacute;t&eacute; ajout&eacute; 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 &quot;ForceType&quot;, pour g&eacute;n&eacute;er une URL
+       Apache &quot;ForceType&quot;, pour g&eacute;n&eacute;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&eacute;e de votre script &quot;/path/to/script.php&quot;.
       </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&eacute;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&eacute;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 &eacute;t&eacute;
-     trouv&eacute;e, retourne &false;. Voir <function>getimagesize</function> pour un 
exemple.
+     trouv&eacute;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&eacute;e une fuite de m&eacute;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&icirc;ne binaire,
@@ -573,14 +654,14 @@
     </para>
     <para>
      L'id&eacute;e vient du Perl et tout le formatage fonctionne de
-     la m&ecirc;me fonction qu'en Perl, mais quelques formats manquent
+     la m&ecirc;me fa&ccedil;on qu'en Perl, mais quelques formats manquent
      encore (comme, "u" ). La cha&icirc;ne de format est compos&eacute;e
-     d'une s&eacute;rie de code de formats, suivis par un quantificateur
+     d'une s&eacute;rie de codes de formats, suivis par un quantificateur
      optionnel. Le quantificateur peut &ecirc;tre un entier, ou *
      pour la r&eacute;p&eacute;tition ind&eacute;finie. Pour les formats a,
      A, h et H, le quantificateur sp&eacute;cifie combien de
-     caract&egrave;res d'un argument sont pris; pour @, c'est
-     la position absolue o&uacute; placer les donn&eacute;es,
+     caract&egrave;res d'un argument sont pris; pour &#64;, c'est
+     la position absolue o&ugrave; placer les donn&eacute;es,
      et pour le reste, c'est le nombre de r&eacute;p&eacute;titions.
      Actuellement, les formats suivants sont impl&eacute;ment&eacute;s :
      <itemizedlist>
@@ -686,7 +767,7 @@
       </listitem>
       <listitem>
        <simpara>
-         @ rempli avec &null;, jusqu'&agrave; une position absolue
+         &#64; rempli avec &null;, jusqu'&agrave; une position absolue
        </simpara>
       </listitem>
      </itemizedlist>
@@ -694,7 +775,7 @@
       <title>Compactage d'une cha&icirc;ne</title>
       <programlisting role="php">
 &lt;?php
-$binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66);
+  $binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66);
 ?&gt;
       </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&eacute;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&eacute;n&eacute;re un identifiant unique.</refpurpose>
+    <refpurpose>G&eacute;n&egrave;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&eacute;rer
      des cookies, il est recommand&eacute; d'utiliser un code
-     tel que celui ci :
+     tel que celui-ci :
      <informalexample>
       <programlisting role="php">
 &lt;?php
@@ -823,7 +910,7 @@
      </informalexample>
     </para>
     <simpara>
-     Ceci va cr&eacute;er un identifiant de 32 caract&egrave;re
+     Ceci va cr&eacute;er un identifiant de 32 caract&egrave;res
      (un nombre hexad&eacute;cimal de 128 ) qui sera tr&egrave;s
      difficile &agrave; pr&eacute;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&eacute;conditionne des donn&eacute;es
      depuis une cha&icirc;ne binaire avec le format
-     <parameter>format</parameter>. Retourne un tableau contenant
+     <parameter>format</parameter>. <function>unpack</function> retourne un tableau 
+contenant
      les &eacute;l&eacute;ments d&eacute;conditionn&eacute;s.
     </para>
     <para>
@@ -869,7 +958,7 @@
      </example>
     </para>
     <para>
-     Pour plus de d&eacute;tails, reportez vous &agrave;:
+     Pour plus de d&eacute;tails, reportez-vous &agrave;:
      <function>pack</function>
     </para>
     <para>
@@ -877,7 +966,7 @@
       sous forme sign&eacute;e. Si vous d&eacute;conditionnez
       une valeur qui est aussi grande que la taille utilis&eacute;e
       en interne par PHP, le r&eacute;sultat se trouvera &ecirc;tre
-      un nombre n&eacute;gatif, m&ecirc;me si il a &eacute;t&eacute;
+      un nombre n&eacute;gatif, m&ecirc;me s'il a &eacute;t&eacute;
       d&eacute;conditionn&eacute; avec l'option " non sign&eacute; ".
     </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&eacute;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>