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

[Damien Seguy]

dams            Mon Oct 29 14:15:32 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        array.xml 
  Log:
  Added array fill, corrected some typos.
  
Index: phpdoc/fr/functions/array.xml
diff -u phpdoc/fr/functions/array.xml:1.41 phpdoc/fr/functions/array.xml:1.42
--- phpdoc/fr/functions/array.xml:1.41  Fri Aug 10 08:59:15 2001
+++ phpdoc/fr/functions/array.xml       Mon Oct 29 14:15:32 2001
@@ -1,12 +1,14 @@
-<!-- $Revision: 1.41 $ -->
+<?xml encoding="iso-8859-1"?>
+<!-- $Revision: 1.42 $ -->
 <reference id="ref.array">
  <title>Tableaux</title>
  <titleabbrev>Tableaux</titleabbrev>
  <partintro>
   <simpara>
    Ces fonctions vous permettent de manipuler et de traiter les tableaux
-   de nombreuses fa&ccedil;ons. Les tableaux sont tr&egrave;s efficaces d&egrave;s
-   qu'il s'agit de stocker, g&eacute;rer et traiter des donn&eacute;es en groupe.
+   de nombreuses fa&ccedil;ons. Les tableaux sont tr&egrave;s efficaces 
+   d&egrave;s qu'il s'agit de stocker, g&eacute;rer et traiter des
+   donn&eacute;es en groupe.
   </simpara>
   <simpara>
    Les tableaux simples et multi-dimensionnels sont support&eacute;s et peuvent
@@ -217,9 +219,23 @@
    </para>
    <para>
     <varname>$result</varname> contient <literal>array("bleu");</literal>.
-    Les valeurs multiples dans $array1 seront toutes trait&eacute;es de la m&ecirc;me
-    fa&ccedil;on.
+    Les valeurs multiples dans $array1 seront toutes trait&eacute;es de la 
+    m&ecirc;me fa&ccedil;on.
    </para>
+    <note>
+     <simpara>
+      Deux &eacute;l&eacute;ments sont consid&eacute;r&eacute;s comme &eacute;gaux si 
+et seulement si 
+      <literal>(string) $elem1 === (string) $elem2</literal>. En clair :
+      lorsque la repr&eacute;sentation en cha&icirc;ne de caract&egrave;res est 
+identique.
+      <!-- TODO: example of it... -->
+     </simpara>
+    </note>
+    <warning>
+     <simpara>
+      Cette fonction &eacute;tait inutilisable en PHP 4.0.4!
+      <!-- TODO: when exactly was this broken?... -->
+     </simpara>
+    </warning>
    <para>
     Voir aussi
     <function>array_intersect</function>.
@@ -302,12 +318,20 @@
     cl&eacute;s sont les valeurs du pr&eacute;c&eacute;dent tableau,
     et les valeurs sont les cl&eacute;s. <function>array_flip</function>
     ne fonctionne que sur des entiers et des cha&icirc;nes, et affichera une
-    erreur s'il d&eacute;tecte une cl&eacute; ou une valeur de type invalide (tableau,
-    objet, bool&eacute;en, nombre &agrave; virgule flottante).
+    erreur s'il d&eacute;tecte une cl&eacute; ou une valeur de type invalide
+    (tableau, objet, bool&eacute;en, nombre &agrave; virgule flottante).
+   </para>
+   <para>
+    Notez bien que les valeurs de <parameter>trans</parameter> doivent 
+    &ecirc;tre des cl&eacute;s valides, c'est &agrave; dire qu'elles doivent 
+&ecirc;tre des
+    entiers (<type>integer</type>) ou des cha&icirc;nes de caract&egrave;res 
+    (<type>string</type>). Une alerte sera &eacute;mise si une valeur a un type qui 
+    ne convient pas et la paire en question <emphasis>ne sera pas
+    invers&eacute;e</emphasis>.
    </para>
    <para>
-    Si une valeur n'est pas unique, seule la derni&egrave;re cl&eacute; sera 
utilis&eacute;e
-    comme valeur, et toutes les autres seront perdues.
+    Si une valeur n'est pas unique, seule la derni&egrave;re cl&eacute; sera
+    utilis&eacute;e comme valeur, et toutes les autres seront perdues.
    </para>
    <para>
     <function>array_flip</function> retourne &false;
@@ -344,6 +368,50 @@
    </note>
   </refsect1>
  </refentry>
+  <refentry id="function.array-fill">
+   <refnamediv>
+    <refname>array_fill</refname>
+    <refpurpose>Remplis un tableau avec une m&ecirc;me valeur</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>array <function>array_fill</function></funcdef>
+      <paramdef>int <parameter>start_index</parameter></paramdef>
+      <paramdef>int <parameter>num</parameter></paramdef>
+      <paramdef>mixed <parameter>value</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>array_fill</function> cr&eacute;e un tableau avec
+     <parameter>num</parameter> entr&eacute;es de la valeur 
+     <parameter>value</parameter>. Les index commecent &agrave; la valeur
+     <parameter>start_index</parameter>.
+    </para>
+    <para>
+     <example>
+      <title>Exemple avec <function>array_fill</function></title>
+      <programlisting role="php">
+&lt;?gt;
+$a = array_fill(5, 6, 'banane');
+
+/*
+$a est le tableau suivant
+
+$a[5]  = "banane";
+$a[6]  = "banane";
+$a[7]  = "banane";
+$a[8]  = "banane";
+$a[9]  = "banane";
+$a[10] = "banane";
+*/
+?&gt;
+      </programlisting>
+     </example>     
+    </para>
+   </refsect1>
+  </refentry>
  <refentry id="function.array-intersect">
   <refnamediv>
    <refname>array_intersect</refname>
@@ -367,7 +435,21 @@
     qui sont pr&eacute;sentes dans tous les autres arguments.
     Notez que les cl&eacute;s sont pr&eacute;serv&eacute;es.
    </para>
-   <para>
+    <note>
+     <simpara>
+      Deux &eacute;l&eacute;ments sont consid&eacute;r&eacute;s comme &eacute;gaux si 
+et seulement si 
+      <literal>(string) $elem1 === (string) $elem2</literal>. En clair :
+      lorsque la repr&eacute;sentation en cha&icirc;ne de caract&egrave;res est 
+identique.
+      <!-- TODO: example of it... -->
+     </simpara>
+    </note>
+    <warning>
+     <simpara>
+      Cette fonction &eacute;tait inutilisable en PHP 4.0.4!
+      <!-- TODO: when exactly was this broken?... -->
+     </simpara>
+    </warning>
+    <para>
     <example>
      <title>Exemple avec <function>array_intersect</function></title>
      <programlisting role="php">
@@ -380,7 +462,8 @@
     </example>
    </para>
    <para>
-    <varname>$result</varname> contient <literal>array ("a" =&gt; "vert", 
"rouge");</literal>.
+    <varname>$result</varname> contient <literal>array ("a" =&gt; "vert",
+    "rouge");</literal>.
    </para>
    <para>
     Voir aussi
@@ -407,8 +490,8 @@
     </funcprototype>
    </funcsynopsis>
    <para>
-    <function>array_keys</function> retourne les cl&eacute;s num&eacute;riques et
-    litt&eacute;rales du tableau <parameter>input</parameter>.
+    <function>array_keys</function> retourne les cl&eacute;s num&eacute;riques
+    et lit&eacute;rales du tableau <parameter>input</parameter>.
    </para>
    <para>
     Si l'option <parameter>search_value</parameter> est sp&eacute;cifi&eacute;e,
@@ -437,8 +520,8 @@
    </para>
    <note>
     <para>
-     <function>array_keys</function> a &eacute;t&eacute; ajout&eacute;e en PHP 4.
-     Ci-dessous, voici une impl&eacute;mentation qui fonctionnera sous PHP 3:
+     <function>array_keys</function> a &eacute;t&eacute; ajout&eacute;e en PHP
+     4. Ci-dessous, voici une impl&eacute;mentation qui fonctionnera sous PHP 3:
      <example>
       <title>
        Impl&eacute;mentation de <function>array_keys</function> pour
@@ -449,11 +532,12 @@
   function array_keys ($arr, $term="") {
     $t = array();
     while (list($k,$v) = each($arr)) {
-        if ($term &amp;&amp; $v != $term)
+        if ($term &amp;&amp; $v != $term) {
             continue;
             $t[] = $k;
         }
         return $t;
+     }
   }
 ?&gt;
       </programlisting>
@@ -1206,8 +1290,9 @@
    </funcsynopsis>
    <para>
     <function>array_shift</function> extrait la premi&egrave;re valeur d'un
-    tableau et la retourne, en raccourcissant le tableau d'un &eacute;l&eacute;ment,
-    et en d&eacute;placant tous les &eacute;l&eacute;ments vers le bas.
+    tableau et la retourne, en raccourcissant le tableau d'un
+    &eacute;l&eacute;ment, et en d&eacute;placant tous les
+    &eacute;l&eacute;ments vers le bas.
     Si <parameter>array</parameter> est vide, ou n'est pas un tableau,
     <function>array_shift</function> retourne &null;.
    </para>
@@ -1231,7 +1316,8 @@
     <function>array_pop</function>.
     <note>
      <para>
-      <function>array_shift</function> a &eacute;t&eacute; ajout&eacute;e en PHP 4.0.
+      <function>array_shift</function> a &eacute;t&eacute; ajout&eacute;e en PHP
+      4.0.
      </para>
     </note>
    </para>
@@ -1485,10 +1571,24 @@
     <parameter>array</parameter> et retourne un nouveau tableau,
     compl&egrave;tement d&eacute;doublonn&eacute;.
    </para>
+    <note>
+     <simpara>
+      Deux &eacute;l&eacute;ments sont consid&eacute;r&eacute;s comme &eacute;gaux si 
+et seulement si 
+      <literal>(string) $elem1 === (string) $elem2</literal>. En clair :
+      lorsque la repr&eacute;sentation en cha&icirc;ne de caract&egrave;res est 
+identique.
+      <!-- TODO: example of it... -->
+     </simpara>
+    </note>
+    <warning>
+     <simpara>
+      Cette fonction &eacute;tait inutilisable en PHP 4.0.4!
+      <!-- TODO: when exactly was this broken?... -->
+     </simpara>
+    </warning>
    <para>
     Notez que les cl&eacute;s sont pr&eacute;serv&eacute;es.
-    <function>array_unique</function> conserve la cl&eacute; de la premi&egrave;re
-    valeur rencontr&eacute;e, et ignore toutes les suivantes.
+    <function>array_unique</function> conserve la cl&eacute; de la
+    premi&egrave;re valeur rencontr&eacute;e, et ignore toutes les suivantes.
    </para>
    <para>
      <example>
@@ -1509,6 +1609,7 @@
       </programlisting>
      </example>
     </para>
+<!--
     <para>
      Notez aussi que <function>array_unique</function> tient compte du
      type de la valeur. Cela ne porte g&eacute;n&eacute;ralement pas &agrave;
@@ -1516,6 +1617,7 @@
      peuvent &ecirc;tre de diff&eacute;rents types. Cela conduit &agrave; des
      r&eacute;sultats d&eacute;routants.
     </para>
+-->
     <para>
      <example>
       <title><function>array_unique</function> et les types de valeurs</title>
@@ -1579,8 +1681,8 @@
 ?&gt;
      </programlisting>
     </example>
-    Le r&eacute;sultat de cet exemple est que $queue aura 5 &eacute;l&eacute;ments,
-    &agrave; savoir: "p4", "p5", "p6", "p1", et "p3".
+    Le r&eacute;sultat de cet exemple est que $queue aura 5
+    &eacute;l&eacute;ments, &agrave; savoir: "p4", "p5", "p6", "p1", et "p3".
    </para>
    <para>
     Voir aussi
@@ -1589,7 +1691,8 @@
     <function>array_pop</function>.
     <note>
      <para>
-      <function>array_unshift</function> a &eacute;t&eacute; ajout&eacute;e en PHP 
4.0.
+      <function>array_unshift</function> a &eacute;t&eacute; ajout&eacute;e en
+      PHP 4.0.
      </para>
     </note>
    </para>
@@ -1927,10 +2030,9 @@
     (et tout le reste n'aura qu'un &eacute;l&eacute;ment).
    </para>
    <para>
-    <function>count</function> retourne 1 si la variable n'est pas un tableau.
-   </para>
-   <para>
-    <function>count</function> retourne 0 si la variable n'est pas 
cr&eacute;&eacute;e.
+    If <parameter>var</parameter> n'est pas un tableau, <literal>1</literal>
+    sera retourn&eacute; (exception : <literal>count(&null;)</literal> &eacute;gale 
+    <literal>0</literal>).
    </para>
    <para>
     <warning>