com doc/fr: Sync some string functions with EN: reference/strings/functions/levenshtein.xml reference/strings/functions/number-format.xml reference/strings/functions/setlocale.xml reference/strings/functions/strtok.xml reference/strings/functions/strtr.xml

[email protected] (George Peter Banyard)
Newsgroups php.doc.fr
Message-ID <[email protected]>
Commit:    4ade3c4fe695f9cfb91c13901e25b1e8901dba00
Author:    George Peter Banyard <[email protected]>         Sun, 3 Jan 2021 03:55:49 +0100
Parents:   63a8bcc7543e776aa8cd11a3b2059eb38832aba8
Branches:  master

Link:       http://git.php.net/?p=doc/fr.git;a=commitdiff;h=4ade3c4fe695f9cfb91c13901e25b1e8901dba00

Log:
Sync some string functions with EN

Changed paths:
  M  reference/strings/functions/levenshtein.xml
  M  reference/strings/functions/number-format.xml
  M  reference/strings/functions/setlocale.xml
  M  reference/strings/functions/strtok.xml
  M  reference/strings/functions/strtr.xml
diff_4ade3c4fe695f9cfb91c13901e25b1e8901dba00.txt (text/plain, 25.9 KB)
diff --git a/reference/strings/functions/levenshtein.xml b/reference/strings/functions/levenshtein.xml
index 003ba1bb62..1bdd26c67f 100644
--- a/reference/strings/functions/levenshtein.xml
+++ b/reference/strings/functions/levenshtein.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.levenshtein" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xml:id="function.levenshtein" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>levenshtein</refname>
   <refpurpose>Calcule la distance Levenshtein entre deux chaînes</refpurpose>
@@ -13,42 +12,30 @@
   &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>levenshtein</methodname>
-   <methodparam><type>string</type><parameter>str1</parameter></methodparam>
-   <methodparam><type>string</type><parameter>str2</parameter></methodparam>
-  </methodsynopsis>
-  <methodsynopsis>
-   <type>int</type><methodname>levenshtein</methodname>
-   <methodparam><type>string</type><parameter>str1</parameter></methodparam>
-   <methodparam><type>string</type><parameter>str2</parameter></methodparam>
-   <methodparam><type>int</type><parameter>cost_ins</parameter></methodparam>
-   <methodparam><type>int</type><parameter>cost_rep</parameter></methodparam>
-   <methodparam><type>int</type><parameter>cost_del</parameter></methodparam>
+   <methodparam><type>string</type><parameter>string1</parameter></methodparam>
+   <methodparam><type>string</type><parameter>string2</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>insertion_cost</parameter><initializer>1</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>replacement_cost</parameter><initializer>1</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>deletion_cost</parameter><initializer>1</initializer></methodparam>
   </methodsynopsis>
   <para>
    La distance Levenshtein est définie comme le nombre
    minimal de caractères qu'il faut remplacer, insérer ou supprimer
-   pour transformer la chaîne <parameter>str1</parameter> en
-   <parameter>str2</parameter>. La complexité de l'algorithme
+   pour transformer la chaîne <parameter>string1</parameter> en
+   <parameter>string2</parameter>. La complexité de l'algorithme
    est en <literal>O(m*n)</literal>,
    où <literal>n</literal> et <literal>m</literal> sont les tailles
-   respectives de <parameter>str1</parameter> et
-   <parameter>str2</parameter> : c'est plutôt bien, en comparaison
+   respectives de <parameter>string1</parameter> et
+   <parameter>string2</parameter> : c'est plutôt bien, en comparaison
    de <function>similar_text</function>, qui est en
    <literal>O(max(n,m)**3)</literal>, mais cela reste très coûteux.
   </para>
   <para>
-   Dans sa forme la plus simple, <function>levenshtein</function>
-   va prendre uniquement deux chaînes de caractères
-   comme paramètres, et calculer simplement le nombre d'insertions,
-   de remplacements et d'effacements nécessaires pour transformer
-   <parameter>str1</parameter> en <parameter>str2</parameter>.
-  </para>
-  <para>
-   La deuxième variante de la fonction prend trois paramètres
-   supplémentaires qui représentent les coûts d'insertions,
-   de remplacements et d'effacements. C'est une version plus
-   générale de la première fonction, mais qui est un peu moins
-   efficace.
+   Si <parameter>insertion_cost</parameter>, <parameter>replacement_cost</parameter>
+   et/oru <parameter>deletion_cost</parameter> sont différent de <literal>1</literal>,
+   l'algorithme s'adapte pour choisir la transformation la moins coûteuse.
+   E.g. si <code>$insertion_cost + $deletion_cost &lt; $replacement_cost</code>,
+   Aucun remplacement ne sera effectué, mais plutôt des insertions et suppressions.
   </para>
  </refsect1>
 
@@ -57,7 +44,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str1</parameter></term>
+     <term><parameter>string1</parameter></term>
      <listitem>
       <para>
        Une des chaînes à évaluer.
@@ -65,7 +52,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>str2</parameter></term>
+     <term><parameter>string2</parameter></term>
      <listitem>
       <para>
        Une des chaînes à évaluer.
@@ -73,7 +60,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>cost_ins</parameter></term>
+     <term><parameter>insertion_cost</parameter></term>
      <listitem>
       <para>
        Définit le coût de l'insertion.
@@ -81,7 +68,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>cost_rep</parameter></term>
+     <term><parameter>replacement_cost</parameter></term>
      <listitem>
       <para>
        Définit le coût du remplacement.
@@ -89,7 +76,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>cost_del</parameter></term>
+     <term><parameter>deletion_cost</parameter></term>
      <listitem>
       <para>
        Définit le coût de l'effacement.
@@ -109,6 +96,29 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Antérieur à cette version, <function>levenshtein</function> devait être appelée
+       avec soit deux soit cinq arguments.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -187,7 +197,6 @@ Vous voulez dire : carrot ?
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/strings/functions/number-format.xml b/reference/strings/functions/number-format.xml
index 7d12e70e60..4190607d63 100644
--- a/reference/strings/functions/number-format.xml
+++ b/reference/strings/functions/number-format.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.number-format" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xml:id="function.number-format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>number_format</refname>
   <refpurpose>Formate un nombre pour l'affichage</refpurpose>
@@ -12,36 +11,13 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>number_format</methodname>
-   <methodparam><type>float</type><parameter>number</parameter></methodparam>
+   <methodparam><type>float</type><parameter>num</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>decimals</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>decimal_separator</parameter><initializer>"."</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>thousands_separator</parameter><initializer>","</initializer></methodparam>
   </methodsynopsis>
-  <methodsynopsis>
-   <type>string</type><methodname>number_format</methodname>
-   <methodparam><type>float</type><parameter>number</parameter></methodparam>
-   <methodparam><type>int</type><parameter>decimals</parameter><initializer>0</initializer></methodparam>
-   <methodparam><type>string</type><parameter>dec_point</parameter><initializer>"."</initializer></methodparam>
-   <methodparam><type>string</type><parameter>thousands_sep</parameter><initializer>","</initializer></methodparam>
-  </methodsynopsis>
-  <para>
-   Cette fonction accepte un, deux, ou quatre paramètres (et pas trois) :
-  </para>
-  <para>
-   Si seul le paramètre <parameter>number</parameter> est donné,
-   il sera formaté sans partie décimale, mais avec une
-   virgule entre chaque millier.
-  </para>
-  <para>
-   Si les deux paramètres <parameter>number</parameter> et
-   <parameter>decimals</parameter> sont fournis, <parameter>number</parameter> sera
-   formaté avec <parameter>decimals</parameter> décimales,
-   un point (".") comme séparateur décimal et une virgule entre chaque
-   millier.
-  </para>
   <para>
-   Avec quatre paramètres, <parameter>number</parameter> sera
-   formaté avec <parameter>decimals</parameter> décimales,
-   <parameter>dec_point</parameter> comme séparateur décimal, et
-   <parameter>thousands_sep</parameter> comme séparateur de milliers.
+   Formate un nombre avec les milliers groupé et optionnellement des chiffres décimal.
   </para>
  </refsect1>
 
@@ -50,7 +26,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>number</parameter></term>
+     <term><parameter>num</parameter></term>
      <listitem>
       <para>
        Le nombre à formater.
@@ -61,12 +37,14 @@
      <term><parameter>decimals</parameter></term>
      <listitem>
       <para>
-       Définit le nombre de décimales.
+       Définit le nombre de chiffres décimales.
+       Si <literal>0</literal>, le <parameter>decimal_separator</parameter> est
+       omis de la valeur de retour.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>dec_point</parameter></term>
+     <term><parameter>decimal_separator</parameter></term>
      <listitem>
       <para>
        Définit le séparateur pour le point décimal.
@@ -74,7 +52,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>thousands_sep</parameter></term>
+     <term><parameter>thousands_separator</parameter></term>
      <listitem>
       <para>
        Définit le séparateur des milliers.
@@ -88,7 +66,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Une version formatée du nombre <parameter>number</parameter>.
+   Une version formatée du nombre <parameter>num</parameter>.
   </para>
  </refsect1>
  
@@ -105,11 +83,18 @@
      </thead>
      <tbody>
       <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Antérieur à cette version, <function>number_format</function> acceptée
+        un, deux, ou quatre paramètres (mais pas trois).
+       </entry>
+      </row>
+      <row>
        <entry>7.2.0</entry>
        <entry>
         <function>number_format</function> a été modifié pour ne plus permettre de
-        retourner <literal>-0</literal>, précedement <literal>-0</literal> pouvait
-        être retourné pour des cas où <parameter>number</parameter> valait <literal>-0.01</literal>.
+        retourner <literal>-0</literal>, précédemment <literal>-0</literal> pouvait
+        être retourné pour des cas où <parameter>num</parameter> valait <literal>-0.01</literal>.
        </entry>
       </row>
      </tbody>
diff --git a/reference/strings/functions/setlocale.xml b/reference/strings/functions/setlocale.xml
index de143312c6..61f8801c27 100644
--- a/reference/strings/functions/setlocale.xml
+++ b/reference/strings/functions/setlocale.xml
@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
  <refnamediv>
   <refname>setlocale</refname>
@@ -12,15 +11,16 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>setlocale</methodname>
+   <type class="union"><type>string</type><type>false</type></type><methodname>setlocale</methodname>
    <methodparam><type>int</type><parameter>category</parameter></methodparam>
-   <methodparam><type>string</type><parameter>locale</parameter></methodparam>
-   <methodparam rep="repeat"><type>string</type><parameter>locales</parameter></methodparam>
+   <methodparam><type>string</type><parameter>locales</parameter></methodparam>
+   <methodparam rep="repeat"><type>string</type><parameter>rest</parameter></methodparam>
   </methodsynopsis>
+  <simpara>Signature alternative (non supporté avec les arguments nommés) :</simpara>
   <methodsynopsis>
-   <type>string</type><methodname>setlocale</methodname>
+   <type class="union"><type>string</type><type>false</type></type><methodname>setlocale</methodname>
    <methodparam><type>int</type><parameter>category</parameter></methodparam>
-   <methodparam><type>array</type><parameter>locale</parameter></methodparam>
+   <methodparam><type>array</type><parameter>locale_array</parameter></methodparam>
   </methodsynopsis>
   <para>
    Définit les informations de localisation.
@@ -99,22 +99,22 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>locale</parameter></term>
+     <term><parameter>locales</parameter></term>
      <listitem>
       <para>
-       Si <parameter>locale</parameter> est &null; ou la chaîne vide
+       Si <parameter>locales</parameter> est la chaîne vide
        (<literal>""</literal>), les noms de locales seront pris dans l'environnement,
        à partir des variables de même nom que les catégories ci-dessus, ou
        depuis "LANG".
       </para>
       <para>
-       Si <parameter>locale</parameter> vaut <literal>"0"</literal>,
+       Si <parameter>locales</parameter> vaut <literal>"0"</literal>,
        la configuration locale ne sera pas modifiée, et la configuration
        courante sera retournée.
       </para>
       <para>
-       Si <parameter>locale</parameter> est un tableau ou bien est suivi
-       par des paramètres additionnels, alors chaque élément du tableau ou
+       Si <parameter>locales</parameter> est suivi
+       par des paramètres additionnels, alors
        chaque paramètre tente d'être défini comme nouvelle locale jusqu'à ce
        qu'un réussisse. Cela est pratique si la locale est connue sous
        différents noms sur des systèmes différents ou bien pour prévoir une
@@ -123,11 +123,22 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>locales</parameter></term>
+     <term><parameter>rest</parameter></term>
+     <listitem>
+      <para>
+       Paramètres optionnels de chaîne à essayer comme paramètre de locale
+       jusqu'à une réussite.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>locale_array</parameter></term>
      <listitem>
       <para>
-       (Chaîne ou tableau de paramètres optionnel à essayer comme configuration
-       de la locale jusqu'à réussite.)
+       Chaque élément du tableau est essayé à être définie comme la nouvelle
+       locale jusqu'à une réussite. Ceci est utile si une locale est connue
+       sous différent noms sur des systèmes différents ou pour fournis une
+       solution de repli pour une locale potentiellement indisponible.
       </para>
      </listitem>
     </varlistentry>
@@ -215,7 +226,7 @@ echo "L'identifiant de l'allemand sur ce système est '$loc_de'";
   <tip>
    <para>
     Les utilisateurs de Windows trouverons des informations utiles à
-    propos du paramètre <parameter>locale</parameter> sur le site web
+    propos du paramètre <parameter>locales</parameter> sur le site web
     <acronym>MSDN</acronym> de Microsoft.
     Les valeurs de locales supportées peuvent être trouvées
     <link xlink:href="&url.setlocale.lang.win32;">sur la page de la
@@ -227,7 +238,6 @@ echo "L'identifiant de l'allemand sur ce système est '$loc_de'";
  </refsect1>
  
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/strings/functions/strtok.xml b/reference/strings/functions/strtok.xml
index 1693a4cb02..2b6e18e2de 100644
--- a/reference/strings/functions/strtok.xml
+++ b/reference/strings/functions/strtok.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2f4863e1f6066a7bc7802164a8f46cd46b067132 Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtok" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xml:id="function.strtok" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>strtok</refname>
   <refpurpose>Coupe une chaîne en segments</refpurpose>
@@ -12,30 +11,34 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>strtok</methodname>
-   <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <type class="union"><type>string</type><type>false</type></type><methodname>strtok</methodname>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
    <methodparam><type>string</type><parameter>token</parameter></methodparam>
   </methodsynopsis>
+  <simpara>Signature alternative (non supporté avec les arguments nommés) :</simpara>
   <methodsynopsis>
-   <type>string</type><methodname>strtok</methodname>
+   <type class="union"><type>string</type><type>false</type></type><methodname>strtok</methodname>
    <methodparam><type>string</type><parameter>token</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>strtok</function> coupe la chaîne <parameter>str</parameter>
+   <function>strtok</function> coupe la chaîne <parameter>string</parameter>
    en segments, chaque segment étant délimité par <parameter>token</parameter>.
    Par exemple, si vous avez une chaîne telle que
    <literal>"Voici un bon exemple"</literal>, vous pouvez en extraire les
-   différents mots en utilisant cette fonction.
+   différents mots en utilisant l'espace comme <parameter>token</parameter>.
   </para>
   <para>
-   Notez que seul le premier appel à <function>strtok</function>
-   nécessite les deux arguments. Tous les appels ultérieurs à
-   <function>strtok</function> ne nécessitent que le délimiteur.
-   Pour initialiser à nouveau <function>strtok</function>,
-   ou pour recommencer, fournissez à nouveau le paramètre
-   <parameter>str</parameter>. La chaîne <parameter>str</parameter>
-   sera découpée dès que l'un des caractères de <parameter>token</parameter>
-   est trouvé.
+   Notez que seul le premier appel à <function>strtok</function> utilise
+   l'argument <parameter>string</parameter>.
+   Tous les appels ultérieurs à <function>strtok</function> nécessitent uniquement
+   le <parameter>token</parameter> à utiliser, car elle sait où elle se situe
+   dans la chaîne courante.
+   Pour recommencer ou découper une nouvelle chaîne vous pouvez simplement
+   appeler <function>strtok</function> avec le paramètre <parameter>string</parameter>
+   de nouveau pour l'initialiser. Il est à noter qu'il est possible de mettre
+   plusieurs tokens dans le paramètre <parameter>token</parameter>.
+   La chaîne <parameter>string</parameter> sera découpée dès que l'un des
+   caractères de l'argument <parameter>token</parameter> est trouvé.
   </para>
  </refsect1>
 
@@ -44,10 +47,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
-       La chaîne que l'on doit couper en plusieurs chaînes de tailles plus petites.
+       La chaîne à découper en plusieurs chaînes de tailles plus petites (tokens).
       </para>
      </listitem>
     </varlistentry>
@@ -55,7 +58,7 @@
      <term><parameter>token</parameter></term>
      <listitem>
       <para>
-       Le délimiteur utilisé lors de la découpe.
+       Le délimiteur utilisé pour découper <parameter>string</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -66,7 +69,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Une chaîne coupée.
+   Une <type>string</type> coupée, ou &false; si plus aucun token n'est disponible.
   </para>
  </refsect1>
 
@@ -131,7 +134,6 @@ var_dump($first_token, $second_token);
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/strings/functions/strtr.xml b/reference/strings/functions/strtr.xml
index b75730d322..1459f7863c 100644
--- a/reference/strings/functions/strtr.xml
+++ b/reference/strings/functions/strtr.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtr" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xml:id="function.strtr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>strtr</refname>
   <refpurpose>Remplace des caractères dans une chaîne</refpurpose>
@@ -13,18 +12,19 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>strtr</methodname>
-   <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
    <methodparam><type>string</type><parameter>from</parameter></methodparam>
    <methodparam><type>string</type><parameter>to</parameter></methodparam>
   </methodsynopsis>
+  <simpara>Signature alternative (non supporté avec les arguments nommés) :</simpara>
   <methodsynopsis>
    <type>string</type><methodname>strtr</methodname>
-   <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
    <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam>
   </methodsynopsis>
   <para>
    Si trois arguments sont utilisés, <function>strtr</function> retourne la chaîne
-   <parameter>str</parameter> après avoir remplacé chaque caractère (de un octet)
+   <parameter>string</parameter> après avoir remplacé chaque caractère (de un octet)
    du paramètre <parameter>from</parameter> par son équivalent dans le paramètre
    <parameter>to</parameter>, chaque occurence de <literal>$from[$n]</literal> est
    remplacée par <literal>$to[$n]</literal>, où <literal>$n</literal> est une valeur
@@ -33,12 +33,12 @@
   <para>
    Si <parameter>from</parameter> et <parameter>to</parameter> sont de
    tailles différentes, les caractères en trop dans l'un ou l'autre
-   seront ignorés. La taille de <parameter>str</parameter> sera la même que celle
+   seront ignorés. La taille de <parameter>string</parameter> sera la même que celle
    des valeurs retournées.
   </para>
   <para>
    Si seuls deux arguments sont utilisés, le deuxième doit être un <type>array</type>
-   de la forme <literal>array('from' => 'to', ...)</literal>. La donnée retournée est
+   de la forme <literal>array('from' =&gt; 'to', ...)</literal>. La donnée retournée est
    une <type>string</type> dans laquelle toutes les occurrences des clés du tableau ont
    été remplacées par les valeurs correspondantes. Les clés les plus longues seront d'abord
    utilisées. Une fois une sous-chaine remplacée, sa nouvelle valeur ne sera plus recherchée.
@@ -46,7 +46,7 @@
   <para>
    Dans ce cas, les clés et les valeurs peuvent avoir n'importe quelle taille, en supposant
    qu'il n'y a pas de clé vide; aussi, la taille de la valeur retournée peut différer de celle
-   de <parameter>str</parameter>. Cependant, cette fonction sera la plus efficace lorsque toutes
+   de <parameter>string</parameter>. Cependant, cette fonction sera la plus efficace lorsque toutes
    les clés ont la même taille.
   </para>
  </refsect1>
@@ -56,7 +56,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        La chaîne à traiter.
@@ -86,7 +86,12 @@
        Le paramètre <parameter>replace_pairs</parameter> peut être utilisé
        à la place de <parameter>to</parameter> et <parameter>from</parameter>
        et dans ce cas, ce sera un tableau sous la forme
-       <literal>array('from' => 'to', ...)</literal>.
+       <literal>array('from' =&gt; 'to', ...)</literal>.
+      </para>
+      <para>
+       Si <parameter>replace_pairs</parameter> contient une clé qui est une
+       <type>string</type> vide (<literal>""</literal>), l'élément est ignoré ;
+       à partir de PHP 8.0.0 une <constant>E_WARNING</constant> est levé dans ce cas.
       </para>
      </listitem>
     </varlistentry>
@@ -99,13 +104,6 @@
   <para>
    Retourne la &string; modifiée.
   </para>
-  <para>
-   Si <parameter>replace_pairs</parameter> contient une clé vide
-   (<literal>""</literal>), &false; sera retourné. Si le paramètre
-   <parameter>str</parameter> n'est pas un scalaire, alors il ne sera
-   pas transtypé en une chaîne de caractères, une alerte sera émise,
-   et la valeur &null; sera retournée.
-  </para>
  </refsect1>
 
  <refsect1 role="examples">
@@ -184,7 +182,6 @@ ba01
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.