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

[Damien Seguy]

dams            Fri Jul 20 03:56:11 2001 EDT

  Modified files:              
    /phpdoc/fr/language functions.xml 
  Log:
  Added last paragraph
  
Index: phpdoc/fr/language/functions.xml
diff -u phpdoc/fr/language/functions.xml:1.7 phpdoc/fr/language/functions.xml:1.8
--- phpdoc/fr/language/functions.xml:1.7        Mon Mar 19 12:06:31 2001
+++ phpdoc/fr/language/functions.xml    Fri Jul 20 03:56:11 2001
@@ -1,9 +1,9 @@
  <chapter id="function">
-  <title>Fonctions</title>
+  <title>Les fonctions</title>
   <sect1 id="functions.user-defined">
-   <title>Les fonctions utilisateurs</title>
+   <title>Les fonctions utilisateur</title>
    <para>
-    une fonction peut &ecirc;tre d&eacute;finie en utilisant la syntaxe suivante :
+    Une fonction peut &ecirc;tre d&eacute;finie en utilisant la syntaxe suivante :
     <informalexample>
      <programlisting role="php">
 &lt;?php
@@ -49,10 +49,10 @@
    </simpara>
    <para>
      PHP supporte le passage d'arguments <link linkend="functions.arguments.default">
-     par valeur</link> (m&eacute;thode par d&eacute;faut), par
+     par valeur</link> (m&eacute;thode par d&eacute;faut),
      <link linkend="functions.arguments.by-reference">par 
r&eacute;f&eacute;rence</link>.
-     Les listes variable d'arguments sont support&eacute;es par PHP 4
-     et plus r&eacute;cent. Voir
+     Les listes variables d'arguments sont support&eacute;es par PHP 4
+     et les versions plus r&eacute;centes. Voir
      <link linkend="functions.variable-arg-list">liste variable d'arguments de 
fonction</link>
      et les fonctions utiles que sont <function>func_num_args</function>,
      <function>func_get_arg</function>, et <function>func_get_args</function>.
@@ -73,7 +73,7 @@
        &agrave; la fonction par valeur (donc vous pouvez
        changer la valeur d'un argument dans la fonction, cela ne
        change pas sa valeur &agrave; l'ext&eacute;rieur de la
-       fonction). Si vous voulez que vos fonctions puisse
+       fonction). Si vous voulez que vos fonctions puissent
        changer la valeur des arguments, vous devez passer ces
        arguments par r&eacute;f&eacute;rence.
     </simpara>
@@ -136,7 +136,7 @@
     <simpara>
      La valeur par d&eacute;faut d'un argument doit
      obligatoirement &ecirc;tre une constante, et ne peut &ecirc;tre
-     ni une variable ou ni un membre de classe.
+     ni une variable, ni un membre de classe.
     </simpara>
     <para>
      Il est &agrave; noter que si vous utilisez des arguments avec
@@ -178,7 +178,7 @@
      </informalexample>
     </para>
     <para>
-     L'affichage de cette exemple est le suivant :
+     L'affichage de cet exemple est le suivant :
      <screen>
 Pr&eacute;parer un bol de acidophilus framboise.
      </screen>
@@ -195,8 +195,8 @@
     <simpara>
      Aucune syntaxe particuli&egrave;re n'est n&eacute;cessaire, et
      la liste d'argument doit toujours &ecirc;tre fournie
-     explicitement avec la d&eacute;fintion de la fonction, et se
-     comportera comme normalement.
+     explicitement avec la d&eacute;finition de la fonction, et se
+     comportera normalement.
     </simpara>
    </sect2>
   </sect1>
@@ -204,14 +204,16 @@
    <title>Les valeurs de retour</title>
    <para>
      Les valeurs sont renvoy&eacute;es en utilisant une
-     instruction de retour optionnelle. Tous types de variables
-     peuvent &ecirc;tre renvoy&eacute;es, tableaux et objets compris.
+     instruction de retour optionnelle. Tous les types de variables
+     peuvent &ecirc;tre renvoy&eacute;s, tableaux et objets compris.
     <informalexample>
      <programlisting role="php">
+&lt;?php
 function carre ($num) {
     return $num * $num;
 }
 echo carre (4);   // affiche '16'.
+?&gt;
      </programlisting>
     </informalexample>
    </para>
@@ -221,23 +223,27 @@
      en renvoyant un tableau.
     <informalexample>
      <programlisting role="php">
+&lt;?php
 function petit_nombre() {
     return array (0, 1, 2);
 }
 list ($zero, $one, $two) = petit_nombre();
+?&gt;
      </programlisting>
     </informalexample>
    </para>
    <para>
-    Pour retourner une r&eacute;f&eacute;rence d'une fonction,&amp;
-    aussi bien dans la d&eacute;claration de la fonction que dans
+    Pour retourner une r&eacute;f&eacute;rence d'une fonction, utilisez
+    l'op&eacute;rateur &amp; aussi bien dans la d&eacute;claration de la fonction que 
+dans
     l'assignation de la valeur de retour.
     <informalexample>
      <programlisting role="php">
+&lt;?php
 function &amp;retourne_reference() {
     return $uneref;
 }
 $newref =&amp;retourne_reference();
+?&gt;
      </programlisting>
     </informalexample>
    </para>
@@ -258,23 +264,30 @@
    <warning>
     <para>
      Les fonctions d&eacute;clar&eacute;es comme <literal>old_function</literal>
-     ne peuvent pas &ecirc;tre appel&eacute;e &agrave; partir du code
+     ne peuvent pas &ecirc;tre appel&eacute;es &agrave; partir du code
      interne du PHP. Cela signifie, par exemple, que vous ne
      pouvez pas les utiliser avec des fonctions comme <function>usort</function>,
      <function>array_walk</function>, et 
<function>register_shutdown_function</function>.
      Vous pouvez contourner ce probl&egrave;me en &eacute;crivant une fonction
-     d'encapsulation qui appelera la fonction <literal>old_function</literal>.
+     d'encapsulation qui appellera la fonction <literal>old_function</literal>.
     </para>
    </warning>
   </sect1>
   <sect1 id="functions.variable-functions">
-   <title>Variable functions</title>
+   <title>Fonctions-variable</title>
    <para>
     PHP supporte le concept de fonctions variables. Cela signifie
     que si le nom d'une variable est suivi de parenth&egrave;ses,
     PHP recherchera une fonction de m&ecirc;me nom,
     et essaiera de l'ex&eacute;cuter. Cela peut servir, entre autre,
-    lors pour faire des fonctions call-back, des tables de fonctions...
+    pour faire des fonctions call-back, des tables de fonctions...
+   </para>
+   <para>
+    Les fonctions-variables ne peuvent pas fonctionner avec les
+    &eacute;l&eacute;ments de langage comme les <function>echo</function>,
+    <function>unset</function>, <function>isset</function>
+    et <function>empty</function>. C'est une des diff&eacute;rences majeures
+    entre les fonctions PHP et les &eacute;l&eacute;ments de langage.
    </para>
    <para>
     <example>
@@ -282,10 +295,10 @@
      <programlisting role="php">
 &lt;?php
 function foo() {
-    echo "dans foo()&lt;br>\n";
+    echo "dans foo()&lt;br&gt;\n";
 }
 function bar( $arg = '' ) {
-    echo "Dans bar(); l'argument &eacute;tait '$arg'.&lt;br>\n";
+    echo "Dans bar(); l'argument &eacute;tait '$arg'.&lt;br&gt;\n";
 }
 $func = 'foo';
 $func();