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

[Damien Seguy]

dams            Tue Apr 17 07:02:34 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        strings.xml 
  Log:
  Added strrchr and fixed typos in examples
  
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.39 phpdoc/fr/functions/strings.xml:1.40
--- phpdoc/fr/functions/strings.xml:1.39        Fri Mar 30 09:51:35 2001
+++ phpdoc/fr/functions/strings.xml     Tue Apr 17 07:02:34 2001
@@ -59,8 +59,11 @@
      </note>
     </para>
     <para>
-     Voir aussi <function>stripcslashes</function>, <function>stripslashes</function>,
-     <function>htmlspecialchars</function> et <function>quotemeta</function>.
+     Voir aussi
+     <function>stripcslashes</function>,
+     <function>stripslashes</function>,
+     <function>htmlspecialchars</function> et
+     <function>quotemeta</function>.
     </para>
    </refsect1>
   </refentry>
@@ -89,8 +92,10 @@
      (la valeur nulle).
     </para>
     <para>
-     Voir aussi <function>stripslashes</function>,
-     <function>htmlspecialchars</function> et <function>quotemeta</function>.
+     Voir aussi
+     <function>stripslashes</function>,
+     <function>htmlspecialchars</function> et
+     <function>quotemeta</function>.
     </para>
    </refsect1>
   </refentry>
@@ -152,8 +157,11 @@
      </para>
     </note>
     <para>
-     Voir aussi <function>trim</function>, <function>ltrim</function>,
-     <function>rtrim</function>, et <function>chop</function>.
+     Voir aussi
+     <function>trim</function>,
+     <function>ltrim</function>,
+     <function>rtrim</function> et
+     <function>chop</function>.
     </para>
    </refsect1>
   </refentry>
@@ -384,7 +392,8 @@
         l'int&eacute;grit&eacute; de donn&eacute;es transmises.
     </para>
        <para>
-       Voir aussi: <function>md5</function>
+       Voir aussi
+       <function>md5</function>.
        </para>
    </refsect1>
   </refentry>
@@ -421,10 +430,10 @@
       Le type d'encryption est alors choisi en fonction du grain de sel.
       A l'installation, PHP d&eacute;termine les possibilit&eacute;s de cryptage et
       d&eacute;cidera d'accepter d'autres grains de sel pour d'autres types
-      d'encryption. Si le grain de sel n'est pas fourni, PHP g&eacute;n&eacute;rera
+      d'encryption. Si le grain de sel n'est pas fourni, PHP g&eacute;n&egrave;rera
       alors un grain de 2 caract&egrave;res, pour le DES standard, &agrave; moins
       que le syst&egrave;me ne dispose de MD5 : dans ce cas, PHP
-      g&eacute;n&eacute;rera un grain de sel pour MD, par d&eacute;faut.
+      g&eacute;n&egrave;rera un grain de sel pour MD, par d&eacute;faut.
       PHP affecte la variable d'environnement CRYPT_SALT_LENGTH, &agrave;
       2 si il utilise le DES standard, et &agrave; 12 si il utilise le MD5.
     </simpara>
@@ -457,12 +466,12 @@
      </listitem>
      <listitem>
       <simpara>
-       CRYPT_MD5 - MD5 avec 12-octets SALT commencant &agrave; $1$
+       CRYPT_MD5 - MD5 avec 12-octets SALT commen&ccedil;ant &agrave; $1$
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       CRYPT_BLOWFISH - DES &eacute;tendu avec 16-octets SALT commencant &agrave; $2$
+       CRYPT_BLOWFISH - DES &eacute;tendu avec 16-octets SALT commen&ccedil;ant 
+&agrave; $2$
       </simpara>
      </listitem>
     </itemizedlist>
@@ -505,11 +514,11 @@
 r&eacute;partis sur plusieurs lignes. Les nouvelles lignes
 seront aussi affich&eacute;es";
 echo "et echo se\nr&eacute;partis sur plusieurs lignes. Les nouvelles lignes\nseront 
aussi affich&eacute;es.";
-echo "L'&eacute;chappement de caract&egrave;res est fait : \"comme ceci\"."
+echo "L'&eacute;chappement de caract&egrave;res est fait : \"comme ceci\".";
 //Vous pouvez utiliser des variables avec echo
 $foo = "foobar";
 $bar = "barbaz";
-echo "foo vaut &quot;$foo&quot;";
+echo "foo vaut &amp;quot;$foo&amp;quot;";
 // foo vaut "foobar"
 // Les guillemets simple &eacute;vitent le remplacement des variables
 echo 'foo is $foo'; // foo vaut $foo
@@ -582,7 +591,9 @@
       </para>
     </note>
     <para>
-       Voir aussi <function>split</function> et <function>implode</function>.
+       Voir aussi
+       <function>split</function> et
+       <function>implode</function>.
     </para>
    </refsect1>
   </refentry>
@@ -726,7 +737,8 @@
          les c&eacute;sures de mots.
     </para>
        <para>
-     Voir aussi <function>hebrevc</function>
+     Voir aussi
+     <function>hebrevc</function>
     </para>
    </refsect1>
   </refentry>
@@ -759,7 +771,8 @@
          d'&eacute;viter les c&eacute;sures de mots.
     </para>
        <para>
-     Voir aussi <function>hebrev</function>
+     Voir aussi
+     <function>hebrev</function>
     </para>
    </refsect1>
   </refentry>
@@ -797,7 +810,9 @@
       PHP 3.0.17 et PHP 4.0.3.
     </para>
     <para>
-     Voir aussi <function>htmlspecialchars</function> et <function>nl2br</function>.
+     Voir aussi
+     <function>htmlspecialchars</function> et
+     <function>nl2br</function>.
     </para>
    </refsect1>
   </refentry>
@@ -858,7 +873,8 @@
        <simpara>
         '&#039;' (guillemet simple) devient '&amp;#039;' si ENT_QUOTES est actif
        </simpara>
-      </listitem>      <listitem>
+      </listitem>
+      <listitem>
        <simpara>
         '&lt;' (inf&eacute;rieur &agrave;) devient '&amp;lt;'
        </simpara>
@@ -886,7 +902,9 @@
         a &eacute;t&eacute; ajout&eacute; PHP 3.0.17 et PHP 4.0.3.
     </para>
     <para>
-     Voir aussi <function>htmlentities</function> et <function>nl2br</function>.
+     Voir aussi
+     <function>htmlentities</function> et
+     <function>nl2br</function>.
     </para>
    </refsect1>
   </refentry>
@@ -931,8 +949,10 @@
      </para>
     </note>
     <simpara>
-     Voir aussi <function>explode</function>, <function>join</function>,
-     et <function>split</function>.
+     Voir aussi
+     <function>explode</function>,
+     <function>join</function> et
+     <function>split</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -958,8 +978,10 @@
      et lui est identique en tous points.
     </simpara>
     <simpara>
-     Voir aussi <function>explode</function>, <function>implode</function>,
-     et <function>split</function>.
+     Voir aussi
+     <function>explode</function>,
+     <function>implode</function> et
+     <function>split</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -1081,7 +1103,7 @@
          demand&eacute;e au CPU, et annule l'optimisation des autres variantes.
        </para>
     <para>
-     Voir aussi 
+     Voir aussi
      <function>soundex</function>,
      <function>similar_text</function> et
      <function>metaphone</function>.
@@ -1272,7 +1294,8 @@
      </para>
     </note>
     <para>
-     Voir aussi : <function>setlocale</function>.
+     Voir aussi
+     <function>setlocale</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1298,7 +1321,9 @@
      "\n", "\r", "\t", "\v", "\0", et " ".
     </para>
     <para>
-      Voir aussi <function>chop</function> et <function>trim</function>.
+      Voir aussi
+      <function>chop</function> et
+      <function>trim</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1378,7 +1403,8 @@
       remplac&eacute;es par '&lt;BR&gt;'.
     </para>
     <para>
-      Voir aussi <function>htmlspecialchars</function> et
+      Voir aussi
+      <function>htmlspecialchars</function> et
       <function>htmlentities</function>.
     </para>
    </refsect1>
@@ -1413,7 +1439,8 @@
      </example>
     </para>
     <simpara>
-     Voir aussi <function>chr</function>.
+     Voir aussi
+     <function>chr</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -1471,8 +1498,10 @@
      <function>print</function> affiche <parameter>arg</parameter>.
     </simpara>
     <simpara>
-     Voir aussi : <function>echo</function>, <function>printf</function>,
-     et <function>flush</function>.
+     Voir aussi
+     <function>echo</function>,
+     <function>printf</function> et
+     <function>flush</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -1498,9 +1527,12 @@
      de <function>sprintf</function>.
     </simpara>
     <simpara>
-     Voir aussi : <function>print</function>, <function>sprintf</function>,
-        <function>sscanf</function>, <function>fscanf</function>,
-        et <function>flush</function>.
+     Voir aussi
+     <function>print</function>,
+     <function>sprintf</function>,
+        <function>sscanf</function>,
+        <function>fscanf</function> et
+        <function>flush</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -1552,8 +1584,11 @@
      ci-dessous : <screen>. \\ + * ? [ ^ ] ( $ )</screen>.
     </para>
     <simpara>
-     Voir aussi <function>addslashes</function>, <function>htmlentities</function>,
-     <function>htmlspecialchars</function>, <function>nl2br</function> et
+     Voir aussi
+     <function>addslashes</function>,
+     <function>htmlentities</function>,
+     <function>htmlspecialchars</function>,
+     <function>nl2br</function> et
      <function>stripslashes</function>.
     </simpara>
    </refsect1>
@@ -1586,7 +1621,9 @@
      </example>
     </para>
     <para>
-     Voir aussi <function>trim</function>, <function>ltrim</function>, et
+     Voir aussi
+     <function>trim</function>,
+     <function>ltrim</function> et
      <function>rtrim</function>.
     </para>
    </refsect1>
@@ -1788,9 +1825,9 @@
      Une valeur Soundex est telle que deux mots prononc&eacute;s de
      la m&ecirc;me fa&ccedil;on auront des valeurs Soundex identiques.
      Cela permet d'effectuer des recherches dans les bases de donn&eacute;es,
-     si vous connaissez la prononciation mais pas l'orthographe. 
-     <function>soundex</function> retourne une cha&icirc;ne de 4 
-     caract&egrave;res, commencant par une lettre.
+     si vous connaissez la prononciation mais pas l'orthographe.
+     <function>soundex</function> retourne une cha&icirc;ne de 4
+     caract&egrave;res, commen&ccedil;ant par une lettre.
     </para>
     <para>
      <function>soundex</function> particuli&egrave;re a &eacute;t&eacute;
@@ -1862,7 +1899,7 @@
       </listitem>
       <listitem>
        <simpara>
-        Un argument optionnel <emphasis>alignment specifier</emphasis> qui indique
+        Un argument optionnel <emphasis>alignment sp&eacute;cifier</emphasis> qui 
+indique
         que le r&eacute;sultat doit &ecirc;tre justifi&eacute; &agrave; droite ou
         &agrave; gauche. Par d&eacute;faut, il est justifi&eacute; &agrave; gauche.
         Le caract&egrave;re <literal>-</literal> signifie : justification &agrave;
@@ -1871,13 +1908,13 @@
       </listitem>
       <listitem>
        <simpara>
-       Argument optionnel, <emphasis>width specifier</emphasis> indique le nombre
+       Argument optionnel, <emphasis>width sp&eacute;cifier</emphasis> indique le 
+nombre
            minimum de caract&egrave;res que la conversion devrait retourner.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
-           Argument optionnel, <emphasis>precision specifier</emphasis> indique le 
nombre
+           Argument optionnel, <emphasis>precision sp&eacute;cifier</emphasis> 
+indique le nombre
        de chiffres utilis&eacute; pour afficher un nombre &agrave; virgule flottante.
        Cette option n'a d'effet que sur les nombres &agrave; virgule, double.
        (Une autre fonction pratique pour formater les nombres est :
@@ -1930,6 +1967,60 @@
       </listitem>
      </orderedlist>
     </para>
+       <para>
+       A partir de PHP 4.0.6, le param&egrave;tre <parameter>format</parameter>
+       supportera aussi la num&eacute;rotation des arguments, et leur &eacute;change.
+       Par exemple :
+       <example>
+        <title>Echange d'arguments : cas habituel</title>
+        <programlisting role="php">
+&lt;?php
+$format = "Il y a %d singes dans le %s";
+printf($format,$num,$location);
+?&gt;
+        </programlisting>
+       </example>
+       Cela pourra afficher "Il y a 5 singes dans le baobab". Mais imaginons
+       un instant que nous cr&eacute;ons cette cha&icirc;ne &agrave; partir d'un 
+fichier s&eacute;par&eacute;,
+       ca nous voulons internationaliser le message. On voudra notamment
+       &eacute;crire librement :
+       <example>
+        <title>Echange d'arguments : cas probl&eacute;matique</title>
+        <programlisting role="php">
+&lt;?php
+$format = "Le %s contient %d singes";
+printf($format,$num,$location);
+?&gt;
+        </programlisting>
+       </example>
+       Maintenant, on a un probl&egrave;me. L'ordre d'utilisation des variables
+       dans la cha&icirc;ne de formatage n'est pas celui d'appel de la
+       fonction <function>sprintf</function>. L'id&eacute;al serait de pouvoir
+       laisser l'ordre des arguments, quel que soit l'ordre des variables
+       fournis. Il faudrait donc indiquer dans la cha&icirc;ne de formatage
+       dans quel ordre utiliser les valeurs. On pourrait &eacute;crire ceci
+       &agrave; la place:
+       <example>
+        <title>Echange d'arguments : solution</title>
+        <programlisting role="php">
+&lt;?php
+$format = "Le %2\$s contient %1\$d singes";
+printf($format,$num,$location);
+?&gt;
+        </programlisting>
+       </example>
+       Et vous pouvez d&eacute;sormais r&eacute;p&eacute;ter les variables sans 
+ajouter
+       de nouvel argument. Par exemple :
+       <example>
+        <title>Echange d'arguments : r&eacute;p&eacute;tition</title>
+        <programlisting role="php">
+&lt;?php
+$format = "Le %2\$s contient %1\$d singes.  C'est un beau %2\$s, avec %1\$d signes 
+dessus.";
+printf($format,$num,$location);
+?&gt;
+        </programlisting>
+       </example>
+       </para>
     <simpara>
      Voir aussi
      <function>printf</function>,
@@ -2276,7 +2367,8 @@
        Les doubles antislash sont remplac&eacute;s par des simples.
     </para>
     <simpara>
-      Voir aussi <function>addslashes</function>.
+      Voir aussi
+      <function>addslashes</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -2405,7 +2497,7 @@
        </para>
        <simpara>
         Comme les autres fonctions de comparaisons de cha&icirc;nes, elle retourne
-        une valeur &lt; 0  si <parameter>str1</parameter> est plus petites que
+        une valeur &lt; 0  si <parameter>str1</parameter> est plus petite que
         <parameter>str2</parameter>; &gt; 0 si <parameter>str1</parameter>
         est plus grande que <parameter>str2</parameter>, et 0 si elles sont 
&eacute;gales.
     </simpara>
@@ -2453,7 +2545,7 @@
        </para>
        <simpara>
         Comme les autres fonctions de comparaisons de cha&icirc;nes, elle retourne
-        une valeur &lt; 0  si <parameter>str1</parameter> est plus petites que
+        une valeur &lt; 0  si <parameter>str1</parameter> est plus petite que
         <parameter>str2</parameter>; &gt; 0 si <parameter>str1</parameter>
         est plus grande que <parameter>str2</parameter>, et 0 si elles sont 
&eacute;gales.
     </simpara>
@@ -2498,7 +2590,7 @@
        </para>
        <simpara>
         Comme les autres fonctions de comparaisons de cha&icirc;nes, elle retourne
-        une valeur &lt; 0  si <parameter>str1</parameter> est plus petites que
+        une valeur &lt; 0  si <parameter>str1</parameter> est plus petite que
         <parameter>str2</parameter>; &gt; 0 si <parameter>str1</parameter>
         est plus grande que <parameter>str2</parameter>, et 0 si elles sont 
&eacute;gales.
      equal.
@@ -2639,6 +2731,7 @@
      Voir aussi
      <function>strrpos</function>,
      <function>strrchr</function>,
+     <function>strchr</function>,
      <function>substr</function>,
      <function>stristr</function> et
      <function>strstr</function>.
@@ -2649,7 +2742,7 @@
    <refnamediv>
     <refname>strrchr</refname>
     <refpurpose>
-     Recherche la partie terminale d'une cha&icirc;ne apr&egrave;s 
+     Recherche la partie terminale d'une cha&icirc;ne apr&egrave;s
      un caract&egrave;re donn&eacute;
     </refpurpose>
    </refnamediv>
@@ -2969,7 +3062,9 @@
      Cette valeur sera confondue avec <literal>FALSE</literal>.
     </para>
     <para>
-     Voir aussi <function>split</function> et <function>explode</function>.
+     Voir aussi
+     <function>split</function> et
+     <function>explode</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3008,7 +3103,9 @@
      </programlisting>
     </example>
     <para>
-     Voir aussi <function>strtoupper</function> et <function>ucfirst</function>.
+     Voir aussi
+     <function>strtoupper</function> et
+     <function>ucfirst</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3046,7 +3143,9 @@
      </programlisting>
     </example>
     <para>
-     Voir aussi <function>strtolower</function> et <function>ucfirst</function>.
+     Voir aussi
+     <function>strtolower</function> et
+     <function>ucfirst</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3115,8 +3214,8 @@
      </para>
     </note>
     <para>
-     Voir aussi 
-     <function>ereg_replace</function>, 
+     Voir aussi
+     <function>ereg_replace</function>,
      <function>preg_replace</function> et
      <function>strtr</function>.
     </para>
@@ -3270,7 +3369,9 @@
      </informalexample>
     </para>
     <para>
-     Voir aussi <function>strrchr</function> et <function>ereg</function>.
+     Voir aussi
+     <function>strrchr</function> et
+     <function>ereg</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3370,7 +3471,9 @@
      </example>
     </para>
     <para>
-     Voir aussi <function>str_replace</function> et <function>substr</function>.
+     Voir aussi
+     <function>str_replace</function> et
+     <function>substr</function>.
     </para>
     <note>
      <simpara>
@@ -3400,7 +3503,9 @@
      espaces blancs sont : "\n", "\r", "\t", "\v", "\0", et " " (espace).
     </para>
     <para>
-     Voir aussi <function>chop</function> et <function>ltrim</function>.
+     Voir aussi
+     <function>chop</function> et
+     <function>ltrim</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3440,7 +3545,9 @@
      </example>
     </para>
     <para>
-     Voir aussi <function>strtoupper</function> et <function>strtolower</function>.
+     Voir aussi
+     <function>strtoupper</function> et
+     <function>strtolower</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3482,7 +3589,9 @@
       </simpara>
      </note>
     <para>
-     Voir aussi <function>strtoupper</function>, <function>strtolower</function> et
+     Voir aussi
+     <function>strtoupper</function>,
+     <function>strtolower</function> et
      <function>ucfirst</function>.
     </para>
    </refsect1>
@@ -3555,7 +3664,7 @@
 Ma&icirc;tre corbeau
  jura, mais un peu t
 ard, qu'on ne l'y pr
-endrait plus
+endrait plus.
        </computeroutput>
       </literallayout>
      </informalexample>
@@ -3585,12 +3694,14 @@
 mooooooo
 oooooooo
 oooooooo
+oot.
        </computeroutput>
       </literallayout>
      </informalexample>
     </para>
     <para>
-     Voir aussi <function>nl2br</function>.
+     Voir aussi
+     <function>nl2br</function>.
     </para>
    </refsect1>
   </refentry>