cvs: phpdoc /fr/language constants.xml
| From: | Damien Seguy | Date: | Mon, 23 Jul 2001 16:49:48 +0000 |
| Subject: | cvs: phpdoc /fr/language constants.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336458@lists.php.net to get a copy of this message | ||
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ésente une valeur + simple. Comme leur nom le suggère, cette valeur ne peut jamais être + modifiée durant l'exécution du script (les constantes magiques + <constant>__FILE__</constant> et + <constant>__LINE__</constant> sont les seules exception). Le nom d'une constante + est sensible à la casse, apr défaut. Par convention, les constantes sont + toujours en majuscules. + </simpara> + <para> + Les noms de constantes suivent les mêmes règles que n'importe + quel nom en PHP. Un nom de constante valide commence par une + lettre ou un souligné (<literal>_</literal>), suivi d'un nombre + quelconque de lettre, chiffres ou soulignés. Sous forme d'expression + réguliè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 être un des caractères + suivants : de a à z, de A à Z et tous les caractères ASCII + de 127 à 255 (0x7f-0xff). + </simpara> + </note> + <simpara> + Les constantes sont accessibles de manière globale. + </simpara> + <sect1 id="language.constants.syntax"> + <title>Syntaxe</title> + <simpara> + Vous pouvez définir une constante en utilisant la fonction + <function>define</function>. Une fois qu'une constante est définie, + elle ne peut jamais être modifiée, ou détruite. + </simpara> + <simpara> + Seuls les types de données scalaires peuvent être placés dans une + constante : c'est à dire les types booléen, entier, double et + chaîne de caractères (soit <type>boolean</type>, <type>integer</type>, + <type>double</type> et <type>string</type>). + </simpara> + <simpara> + Vous povuez accéder à la valeur d'une constante en spécifiant simplement + son nom. Contrairement aux variables, vous ne devez <emphasis>PAS</emphasis> pré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ître + la liste de toutes les fonctions définies. + </simpara> + <note> + <simpara> + Les constantes et les variables globales utilisent deux espaces de + noms différents. Ce qui implique que &true; et + <varname>$TRUE</varname> sont généralement différents (en tous cas, ils + peuvent avoir des valeurs différentes). + </simpara> + </note> <simpara> - PHP définit un certain nombre de constantes et propose des - mécanismes pour en définir d'autres durant l'exécution. - Les constantes se comportent des variables, à l'exception du fait - que leur valeur est définie grâce à la fonction - <function>define</function>, et qu'elle ne peut pas être - modifiée par la suite. + Lorsque vous utilisez une constante non définie, PHP suppose que vous utilisez + le nom de la constante. Une + <link linkend="features.error-handling">note</link> sera générée. Utilisez la + fonction <function>defined</function> pour savoir si une constante existe ou pas. </simpara> <para> - Les constantes prédéfinies (toujours disponibles) sont : + Il y a des diffé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éfinies et accessibles à tout endroit du code, + globalement. + </simpara> + </listitem> + <listitem> + <simpara> + Les constantes ne peuvent pas être redéfinies ou indéfinies une fois qu'elles + ont été dé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> +<?php + define("CONSTANTE", "Bonjour le monde."); + echo CONSTANTE; // affiche "Bonjour le monde." + echo Constante; // affiche "Constante" et une note. +?> + </programlisting> + </example> + </para> + </sect1> + <sect1 id="language.constants.predefined"> + <title>Constantes prédéfinies</title> + <para> + Les constantes prédéfinies sont toujours disponibles. En voici la liste : <variablelist> <varlistentry> - <term>__FILE__</term> + <term>__FILE__ (insensible à la casse)</term> <listitem> <simpara> Le nom du fichier qui est actuellement exécuté. Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (aprè utilisation de <function>require</function>), - alors le nom du fichier inclus est renvoyé, et non le nom + "inclus" (après utilisation de <function>require</function>), + alors le nom du fichier inclus est renvoyée, et non le nom du fichier parent. </simpara> </listitem> </varlistentry> <varlistentry> - <term>__LINE__</term> + <term>__LINE__ (insensible à la casse)</term> <listitem> <simpara> Le numéro de la ligne qui est actuellement exécutée. Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (aprè utilisation de <function>require</function>), + "inclus" (après utilisation de <function>require</function>), c'est la position dans le fichier inclus qui est renvoyé. </simpara> </listitem> @@ -48,7 +146,9 @@ <listitem> <simpara> Nom du système d'exploitation qui est utilisé 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énote un contexte dans lequel le PHP trouve que quelque chose - qui ne va pas. Mais l'exécution se poursuit tout de même. + ne va pas. Mais l'exécution se poursuit tout de même. Ces alertes-là peuvent être récupérées par le script lui-même. Un exemple serait une expression régulière (regexp) invalide dans la fonction @@ -142,7 +242,7 @@ <?php define("CONSTANTE", "Bonjour le monde."); echo CONSTANTE; -// affiche "Bonjourle monde." +// affiche "Bonjour le monde." ?> </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
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ésente une valeur + simple. Comme leur nom le suggère, cette valeur ne peut jamais être + modifiée durant l'exécution du script (les constantes magiques + <constant>__FILE__</constant> et + <constant>__LINE__</constant> sont les seules exception). Le nom d'une constante + est sensible à la casse, apr défaut. Par convention, les constantes sont + toujours en majuscules. + </simpara> + <para> + Les noms de constantes suivent les mêmes règles que n'importe + quel nom en PHP. Un nom de constante valide commence par une + lettre ou un souligné (<literal>_</literal>), suivi d'un nombre + quelconque de lettre, chiffres ou soulignés. Sous forme d'expression + réguliè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 être un des caractères + suivants : de a à z, de A à Z et tous les caractères ASCII + de 127 à 255 (0x7f-0xff). + </simpara> + </note> + <simpara> + Les constantes sont accessibles de manière globale. + </simpara> + <sect1 id="language.constants.syntax"> + <title>Syntaxe</title> + <simpara> + Vous pouvez définir une constante en utilisant la fonction + <function>define</function>. Une fois qu'une constante est définie, + elle ne peut jamais être modifiée, ou détruite. + </simpara> + <simpara> + Seuls les types de données scalaires peuvent être placés dans une + constante : c'est à dire les types booléen, entier, double et + chaîne de caractères (soit <type>boolean</type>, <type>integer</type>, + <type>double</type> et <type>string</type>). + </simpara> + <simpara> + Vous povuez accéder à la valeur d'une constante en spécifiant simplement + son nom. Contrairement aux variables, vous ne devez <emphasis>PAS</emphasis> pré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ître + la liste de toutes les fonctions définies. + </simpara> + <note> + <simpara> + Les constantes et les variables globales utilisent deux espaces de + noms différents. Ce qui implique que &true; et + <varname>$TRUE</varname> sont généralement différents (en tous cas, ils + peuvent avoir des valeurs différentes). + </simpara> + </note> <simpara> - PHP définit un certain nombre de constantes et propose des - mécanismes pour en définir d'autres durant l'exécution. - Les constantes se comportent des variables, à l'exception du fait - que leur valeur est définie grâce à la fonction - <function>define</function>, et qu'elle ne peut pas être - modifiée par la suite. + Lorsque vous utilisez une constante non définie, PHP suppose que vous utilisez + le nom de la constante. Une + <link linkend="features.error-handling">note</link> sera générée. Utilisez la + fonction <function>defined</function> pour savoir si une constante existe ou pas. </simpara> <para> - Les constantes prédéfinies (toujours disponibles) sont : + Il y a des diffé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éfinies et accessibles à tout endroit du code, + globalement. + </simpara> + </listitem> + <listitem> + <simpara> + Les constantes ne peuvent pas être redéfinies ou indéfinies une fois qu'elles + ont été dé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> +<?php + define("CONSTANTE", "Bonjour le monde."); + echo CONSTANTE; // affiche "Bonjour le monde." + echo Constante; // affiche "Constante" et une note. +?> + </programlisting> + </example> + </para> + </sect1> + <sect1 id="language.constants.predefined"> + <title>Constantes prédéfinies</title> + <para> + Les constantes prédéfinies sont toujours disponibles. En voici la liste : <variablelist> <varlistentry> - <term>__FILE__</term> + <term>__FILE__ (insensible à la casse)</term> <listitem> <simpara> Le nom du fichier qui est actuellement exécuté. Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (aprè utilisation de <function>require</function>), - alors le nom du fichier inclus est renvoyé, et non le nom + "inclus" (après utilisation de <function>require</function>), + alors le nom du fichier inclus est renvoyée, et non le nom du fichier parent. </simpara> </listitem> </varlistentry> <varlistentry> - <term>__LINE__</term> + <term>__LINE__ (insensible à la casse)</term> <listitem> <simpara> Le numéro de la ligne qui est actuellement exécutée. Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (aprè utilisation de <function>require</function>), + "inclus" (après utilisation de <function>require</function>), c'est la position dans le fichier inclus qui est renvoyé. </simpara> </listitem> @@ -48,7 +146,9 @@ <listitem> <simpara> Nom du système d'exploitation qui est utilisé 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énote un contexte dans lequel le PHP trouve que quelque chose - qui ne va pas. Mais l'exécution se poursuit tout de même. + ne va pas. Mais l'exécution se poursuit tout de même. Ces alertes-là peuvent être récupérées par le script lui-même. Un exemple serait une expression régulière (regexp) invalide dans la fonction @@ -142,7 +242,7 @@ <?php define("CONSTANTE", "Bonjour le monde."); echo CONSTANTE; -// affiche "Bonjourle monde." +// affiche "Bonjour le monde." ?> </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