[PHP-DOC] cvs: phpdoc /fr/language constants.xml

[Damien Seguy]

dams            Mon Jul 23 12:49:48 2001 EDT

  Modified files:              
    /phpdoc/fr/language constants.xml 
  Log:
  Updating for building
  
Index: phpdoc/fr/language/constants.xml
diff -u phpdoc/fr/language/constants.xml:1.12 phpdoc/fr/language/constants.xml:1.13
--- phpdoc/fr/language/constants.xml:1.12       Sat Jul  7 18:22:32 2001
+++ phpdoc/fr/language/constants.xml    Mon Jul 23 12:49:48 2001
@@ -1,35 +1,133 @@
-  <chapter id="language.constants">
+<chapter id="language.constants">
    <title>Les constantes</title>
+  <simpara>
+   Une constante est un identifiant (un nom) qui repr&eacute;sente une valeur
+   simple. Comme leur nom le sugg&egrave;re, cette valeur ne peut jamais &ecirc;tre
+   modifi&eacute;e durant l'ex&eacute;cution du script (les constantes magiques
+   <constant>__FILE__</constant> et
+   <constant>__LINE__</constant> sont les seules exception). Le nom d'une constante
+   est sensible &agrave; la casse, apr d&eacute;faut. Par convention, les constantes 
+sont
+   toujours en majuscules.
+  </simpara>
+  <para>
+   Les noms de constantes suivent les m&ecirc;mes r&egrave;gles que n'importe
+   quel nom en PHP. Un nom de constante valide commence par une
+   lettre ou un soulign&eacute; (<literal>_</literal>), suivi d'un nombre
+   quelconque de lettre, chiffres ou soulign&eacute;s. Sous forme d'expression
+   r&eacute;guli&egrave;re, cela peut s'exprimer comme ceci :
+   <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>
+  </para>
+  <note>
+   <simpara>
+    Dans cette documentation, une lettre peut &ecirc;tre un des caract&egrave;res
+    suivants : de a &agrave; z, de A &agrave; Z et tous les caract&egrave;res ASCII
+    de 127 &agrave; 255 (0x7f-0xff).
+   </simpara>
+  </note>
+  <simpara>
+   Les constantes sont accessibles de mani&egrave;re globale.
+  </simpara>
+  <sect1 id="language.constants.syntax">
+   <title>Syntaxe</title>
+   <simpara>
+    Vous pouvez d&eacute;finir une constante en utilisant la fonction
+    <function>define</function>. Une fois qu'une constante est d&eacute;finie,
+    elle ne peut jamais &ecirc;tre modifi&eacute;e, ou d&eacute;truite.
+   </simpara>
+   <simpara>
+    Seuls les types de donn&eacute;es scalaires peuvent &ecirc;tre plac&eacute;s dans 
+une
+    constante : c'est &agrave; dire les types bool&eacute;en, entier, double et
+    cha&icirc;ne de caract&egrave;res (soit <type>boolean</type>, 
+<type>integer</type>,
+    <type>double</type> et <type>string</type>).
+   </simpara>
+   <simpara>
+    Vous povuez acc&eacute;der &agrave; la valeur d'une constante en 
+sp&eacute;cifiant simplement
+    son nom. Contrairement aux variables, vous ne devez <emphasis>PAS</emphasis> 
+pr&eacute;fixer
+    le nom de la constante avec <literal>$</literal>.
+    Vous pouvez aussi utiliser la fonction  <function>constant</function>, pour
+    lire dynamiquement la valeur d'une constante, si vous obtenez le nom
+    de cette constante dynamiquement (retour de fonction, par exemple).
+    Utilisez la fonction <function>get_defined_constants</function> pour 
+conna&icirc;tre
+    la liste de toutes les fonctions d&eacute;finies.
+   </simpara>
+   <note>
+    <simpara>
+     Les constantes et les variables globales utilisent deux espaces de
+     noms diff&eacute;rents. Ce qui implique que &true; et
+     <varname>$TRUE</varname> sont g&eacute;n&eacute;ralement diff&eacute;rents (en 
+tous cas, ils
+     peuvent avoir des valeurs diff&eacute;rentes).
+    </simpara>
+   </note>
    <simpara>
-    PHP d&eacute;finit un certain nombre de constantes et propose des
-    m&eacute;canismes pour en d&eacute;finir d'autres durant l'ex&eacute;cution.
-    Les constantes se comportent des variables, &agrave; l'exception du fait
-    que leur valeur est d&eacute;finie gr&acirc;ce &agrave; la fonction
-    <function>define</function>, et qu'elle ne peut pas &ecirc;tre
-    modifi&eacute;e par la suite.
+    Lorsque vous utilisez une constante non d&eacute;finie, PHP suppose que vous 
+utilisez
+    le nom de la constante. Une
+    <link linkend="features.error-handling">note</link> sera 
+g&eacute;n&eacute;r&eacute;e. Utilisez la
+    fonction <function>defined</function> pour savoir si une constante existe ou pas.
    </simpara>
    <para>
-       Les constantes pr&eacute;d&eacute;finies (toujours disponibles) sont :
+    Il y a des diff&eacute;rences entre les constantes et les variables :
+     <itemizedlist>
+      <listitem>
+       <simpara>
+    Les constantes ne commencent pas par le signe (<literal>$</literal>);
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+    Les constantes sont d&eacute;finies et accessibles &agrave; tout endroit du code,
+    globalement.
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+    Les constantes ne peuvent pas &ecirc;tre red&eacute;finies ou ind&eacute;finies 
+une fois qu'elles
+    ont &eacute;t&eacute; d&eacute;finies.
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+    Les constantes ne peuvent contenir que des scalaires.
+       </simpara>
+      </listitem>
+     </itemizedlist>
+    </para>
+   <para>
+    <example>
+     <title>Definir une constante</title>
+     <programlisting>
+&lt;?php
+  define("CONSTANTE", "Bonjour le monde.");
+  echo CONSTANTE; // affiche "Bonjour le monde."
+  echo Constante; // affiche "Constante" et une note.
+?&gt;
+     </programlisting>
+    </example>
+   </para>
+  </sect1>
+  <sect1 id="language.constants.predefined">
+   <title>Constantes pr&eacute;d&eacute;finies</title>
+  <para>
+   Les constantes pr&eacute;d&eacute;finies sont toujours disponibles. En voici la 
+liste :
        <variablelist>
         <varlistentry>
-         <term>__FILE__</term>
+         <term>__FILE__  (insensible &agrave; la casse)</term>
          <listitem>
           <simpara>
                Le nom du fichier qui est actuellement ex&eacute;cut&eacute;.
                Si cette constante est utilis&eacute;e dans le cadre d'un fichier
-               "inclus" (apr&egrave; utilisation de <function>require</function>),
-               alors le nom du fichier inclus est renvoy&eacute;, et non le nom
+               "inclus" (apr&egrave;s utilisation de <function>require</function>),
+               alors le nom du fichier inclus est renvoy&eacute;e, et non le nom
                du fichier parent.
           </simpara>
          </listitem>
         </varlistentry>
         <varlistentry>
-         <term>__LINE__</term>
+         <term>__LINE__ (insensible &agrave; la casse)</term>
          <listitem>
           <simpara>
         Le num&eacute;ro de la ligne qui est actuellement ex&eacute;cut&eacute;e.
         Si cette constante est utilis&eacute;e dans le cadre d'un fichier
-        "inclus" (apr&egrave; utilisation de <function>require</function>),
+        "inclus" (apr&egrave;s utilisation de <function>require</function>),
         c'est la position dans le fichier inclus qui est renvoy&eacute;.
           </simpara>
          </listitem>
@@ -48,7 +146,9 @@
          <listitem>
           <simpara>
          Nom du syst&egrave;me d'exploitation qui est utilis&eacute; par
-         la machine qui fait tourner le PHP. Par exemple, 'Linux'.
+         la machine qui fait tourner le PHP. Parmi les valeurs possibles :
+         "AIX", "Darwin" (MacOS), "Linux", "SunOS", "WIN32", "WINNT".
+         Note : cette liste n'est pas exhaustive.
           </simpara>
          </listitem>
         </varlistentry>
@@ -82,7 +182,7 @@
          <listitem>
           <simpara>
         D&eacute;note un contexte dans lequel le PHP trouve que quelque chose
-        qui ne va pas. Mais l'ex&eacute;cution se poursuit tout de m&ecirc;me.
+        ne va pas. Mais l'ex&eacute;cution se poursuit tout de m&ecirc;me.
         Ces alertes-l&agrave; peuvent &ecirc;tre r&eacute;cup&eacute;r&eacute;es
         par le script lui-m&ecirc;me. Un exemple serait une expression
         r&eacute;guli&egrave;re (regexp) invalide dans la fonction
@@ -142,7 +242,7 @@
 &lt;?php
 define("CONSTANTE", "Bonjour le monde.");
 echo CONSTANTE;
-// affiche "Bonjourle monde."
+// affiche "Bonjour le monde."
 ?&gt;
      </programlisting>
     </example>
@@ -158,7 +258,8 @@
      </programlisting>
     </example>
    </para>
-  </chapter>
+  </sect1>
+ </chapter>
  <!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml