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 @@ - + + Tableaux Tableaux Ces fonctions vous permettent de manipuler et de traiter les tableaux - de nombreuses façons. Les tableaux sont très efficaces dès - qu'il s'agit de stocker, gérer et traiter des données en groupe. + de nombreuses façons. Les tableaux sont très efficaces + dès qu'il s'agit de stocker, gérer et traiter des + données en groupe. Les tableaux simples et multi-dimensionnels sont supportés et peuvent @@ -217,9 +219,23 @@ $result contient array("bleu");. - Les valeurs multiples dans $array1 seront toutes traitées de la même - façon. + Les valeurs multiples dans $array1 seront toutes traitées de la + même façon. + + + Deux éléments sont considérés comme égaux si et seulement si + (string) $elem1 === (string) $elem2. En clair : + lorsque la représentation en chaîne de caractères est identique. + + + + + + Cette fonction était inutilisable en PHP 4.0.4! + + + Voir aussi array_intersect. @@ -302,12 +318,20 @@ clés sont les valeurs du précédent tableau, et les valeurs sont les clés. array_flip ne fonctionne que sur des entiers et des chaînes, et affichera une - erreur s'il détecte une clé ou une valeur de type invalide (tableau, - objet, booléen, nombre à virgule flottante). + erreur s'il détecte une clé ou une valeur de type invalide + (tableau, objet, booléen, nombre à virgule flottante). + + + Notez bien que les valeurs de trans doivent + être des clés valides, c'est à dire qu'elles doivent être des + entiers (integer) ou des chaînes de caractères + (string). Une alerte sera émise si une valeur a un type qui + ne convient pas et la paire en question ne sera pas + inversée. - Si une valeur n'est pas unique, seule la dernière clé sera utilisée - comme valeur, et toutes les autres seront perdues. + Si une valeur n'est pas unique, seule la dernière clé sera + utilisée comme valeur, et toutes les autres seront perdues. array_flip retourne &false; @@ -344,6 +368,50 @@ + + + array_fill + Remplis un tableau avec une même valeur + + + Description + + + array array_fill + int start_index + int num + mixed value + + + + array_fill crée un tableau avec + num entrées de la valeur + value. Les index commecent à la valeur + start_index. + + + + Exemple avec <function>array_fill</function> + +<?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"; +*/ +?> + + + + + array_intersect @@ -367,7 +435,21 @@ qui sont présentes dans tous les autres arguments. Notez que les clés sont préservées. - + + + Deux éléments sont considérés comme égaux si et seulement si + (string) $elem1 === (string) $elem2. En clair : + lorsque la représentation en chaîne de caractères est identique. + + + + + + Cette fonction était inutilisable en PHP 4.0.4! + + + + Exemple avec <function>array_intersect</function> @@ -380,7 +462,8 @@ - $result contient array ("a" => "vert", "rouge");. + $result contient array ("a" => "vert", + "rouge");. Voir aussi @@ -407,8 +490,8 @@ - array_keys retourne les clés numériques et - littérales du tableau input. + array_keys retourne les clés numériques + et litérales du tableau input. Si l'option search_value est spécifiée, @@ -437,8 +520,8 @@ - array_keys a été ajoutée en PHP 4. - Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: + array_keys a été ajoutée en PHP + 4. Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: Implé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 && $v != $term) + if ($term && $v != $term) { continue; $t[] = $k; } return $t; + } } ?> </programlisting> @@ -1206,8 +1290,9 @@ </funcsynopsis> <para> <function>array_shift</function> extrait la première valeur d'un - tableau et la retourne, en raccourcissant le tableau d'un élément, - et en déplacant tous les éléments vers le bas. + tableau et la retourne, en raccourcissant le tableau d'un + élément, et en déplacant tous les + élé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 été ajoutée en PHP 4.0. + <function>array_shift</function> a été ajoutée en PHP + 4.0. </para> </note> </para> @@ -1485,10 +1571,24 @@ <parameter>array</parameter> et retourne un nouveau tableau, complètement dédoublonné. </para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> Notez que les clés sont préservées. - <function>array_unique</function> conserve la clé de la première - valeur rencontrée, et ignore toutes les suivantes. + <function>array_unique</function> conserve la clé de la + première valeur rencontré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énéralement pas à @@ -1516,6 +1617,7 @@ peuvent être de différents types. Cela conduit à des résultats déroutants. </para> +--> <para> <example> <title><function>array_unique</function> et les types de valeurs @@ -1579,8 +1681,8 @@ ?> - Le résultat de cet exemple est que $queue aura 5 éléments, - à savoir: "p4", "p5", "p6", "p1", et "p3". + Le résultat de cet exemple est que $queue aura 5 + éléments, à savoir: "p4", "p5", "p6", "p1", et "p3". Voir aussi @@ -1589,7 +1691,8 @@ array_pop. - array_unshift a été ajoutée en PHP 4.0. + array_unshift a été ajoutée en + PHP 4.0. @@ -1927,10 +2030,9 @@ (et tout le reste n'aura qu'un élément). - count retourne 1 si la variable n'est pas un tableau. - - - count retourne 0 si la variable n'est pas créée. + If var n'est pas un tableau, 1 + sera retourné (exception : count(&null;) égale + 0).