dams Wed May 16 05:28:20 2001 EDT Modified files: /phpdoc/fr/functions array.xml Log: Update with latest changes
Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.30 phpdoc/fr/functions/array.xml:1.31 --- phpdoc/fr/functions/array.xml:1.30 Tue Apr 17 07:31:42 2001 +++ phpdoc/fr/functions/array.xml Wed May 16 05:28:20 2001 @@ -172,7 +172,7 @@ <note> <para> <function>array_count_values</function> a été ajoutée - dans PHP 4.0. + en PHP 4.0. </para> </note> </para> @@ -191,7 +191,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter><optional> ...</optional></parameter> + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -294,8 +294,20 @@ </funcprototype> </funcsynopsis> <para> - <function>array_flip</function> retourne un tableau dont les clés sont les - valeurs du précédent tableau, et les valeurs sont les clés. + <function>array_flip</function> retourne un tableau dont les + clés sont les valeurs du précédent tableau, + et les valeurs sont les clés. <function>array_flip</function> + 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). + </para> + <para> + Si une valeur n'est pas unique, seule la dernière clé sera +utilisée + comme valeur, et toutes les autres seront perdues. + </para> + <para> + <function>array_flip</function> retourne <literal>FALSE</literal> + en cas d'échec. </para> <para> <example> @@ -307,9 +319,20 @@ ?> </programlisting> </example> + <para> + <example> + <title><function>array_flip</function> example : collision</title> + <programlisting role="php"> +$trans = array ("a" => 1, "b" => 1, "c" => 2); +$trans = array_flip ($trans); +// et $trans vaut : array(1 => "b", 2 => "c"); + </programlisting> + </example> + </para> <note> <para> - <function>array_flip</function> a été ajoutée dans PHP 4.0. + <function>array_flip</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -328,7 +351,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter><optional> ...</optional></parameter> + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -379,7 +402,7 @@ </funcsynopsis> <para> <function>array_keys</function> retourne les clés numériques et - litérales du tableau <parameter>input</parameter>. + littérales du tableau <parameter>input</parameter>. </para> <para> Si l'option <parameter>search_value</parameter> est spécifiée, @@ -408,7 +431,7 @@ </para> <note> <para> - <function>array_keys</function> a été ajoutée dans PHP 4. + <function>array_keys</function> a été ajoutée en PHP 4. Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: <example> <title> @@ -482,7 +505,7 @@ </para> <para> <example> - <title><function>array_filter</function> - utilisation de plusieurs tableaux</title> + <title><function>array_map</function> - utilisation de plusieurs tableaux</title> <programlisting role="php"> <?php function parle_espagnol($n, $m) { @@ -553,7 +576,7 @@ <example> <title><function>array_map</function> - création d'un tableau de tableaux</title> <programlisting role="php"> -<?php +<?php $a = array(1, 2, 3, 4, 5); $b = array("un", "deux", "trois", "quatre", "cinq"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); @@ -598,7 +621,7 @@ // ) // // ) -?gt; +?> </programlisting> </example> </para> @@ -622,7 +645,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef> - <parameter><optional> ...</optional></parameter> + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -728,7 +751,8 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>array_multisort</function></funcdef> + <funcdef>boolean + <function>array_multisort</function></funcdef> <paramdef>array <parameter>ar1</parameter></paramdef> <paramdef>mixed <parameter><optional>arg</optional></parameter> @@ -924,7 +948,7 @@ <function>array_unshift</function>. <note> <para> - <function>array_pop</function> a été ajoutée dans PHP 4.0. + <function>array_pop</function> a été ajoutée en PHP 4.0. </para> </note> </para> @@ -985,7 +1009,7 @@ <function>array_unshift</function>. <note> <para> - <function>array_push</function> a été ajoutée dans PHP 4.0. + <function>array_push</function> a été ajoutée en PHP 4.0. </para> </note> </para> @@ -995,8 +1019,7 @@ <refnamediv> <refname>array_reverse</refname> <refpurpose> - Retourne un tableau dont les éléments sont classés en sens - inverse. + Renverse l'ordre des éléments d'un tableau </refpurpose> </refnamediv> <refsect1> @@ -1005,7 +1028,7 @@ <funcprototype> <funcdef>array <function>array_reverse</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>bool + <paramdef>boolean <parameter><optional>preserve_keys</optional></parameter> </paramdef> </funcprototype> @@ -1022,12 +1045,15 @@ <programlisting role="php"> <?php $input = array ("php", 4.0, array ("rouge", "vert")); -$result = array_reverse ($input, TRUE); +$result = array_reverse ($input); +$result_keyed = array_reverse ($input, TRUE); ?> </programlisting> </example> - Au final, $result contient (array ("rouge", "vert"), 4.0, "php"). Mais - <varname>$result2[0]</varname> vaut toujours <literal>"php"</literal>. + Au final, <varname>$result</varname> et <varname>$result_keyed</varname> + contiennent tous les deux <literal>array ("rouge", "vert"), 4.0, "php"</literal>, + dans cet ordre. Mais <varname>$result_keyed[0]</varname> vaut toujours + <literal>"php"</literal>. <note> <para> <function>array_reverse</function> a été ajoutée en @@ -1125,7 +1151,7 @@ </funcsynopsis> <para> <function>array_rand</function> est pratique lorsque vous voulez - selectionner une ou plusieurs valeurs au hasard dans un tableau. + sélectionner une ou plusieurs valeurs au hasard dans un tableau. Le paramètre <parameter>input</parameter> est un tableau, et <parameter>num_req</parameter> spéficie le nombre de valeurs que vous voulez obtenir (par défaut, c'est 1). @@ -1133,8 +1159,8 @@ <para> Si vous ne demandez qu'une entrée, <function>array_rand</function> retourne l'index de la valeur. Sinon, elle retourne un tableau - d'index. Cela vous permet de faire une selection au hasard de clés, - ou bien de valeur. + d'index. Cela vous permet de faire une sélection au hasard de clés, + ou bien de valeurs. </para> <para> N'oubliez pas d'appeler <function>srand</function> pour initialiser le @@ -1198,7 +1224,7 @@ <function>array_pop</function>. <note> <para> - <function>array_shift</function> a été ajoutée dans PHP 4.0. + <function>array_shift</function> a été ajoutée en PHP 4.0. </para> </note> </para> @@ -1272,7 +1298,7 @@ <function>array_splice</function>. <note> <para> - <function>array_slice</function> a été ajoutée dans PHP 4.0. + <function>array_slice</function> a été ajoutée en PHP 4.0. </para> </note> </para> @@ -1382,7 +1408,7 @@ <note> <para> <function>array_splice</function> a été ajoutée - dans PHP 4.0. + en PHP 4.0. </para> </note> </para> @@ -1513,7 +1539,7 @@ <function>array_pop</function>. <note> <para> - <function>array_unshift</function> a été ajoutée dans PHP 4.0. + <function>array_unshift</function> a été ajoutée en PHP +4.0. </para> </note> </para> @@ -1548,7 +1574,7 @@ </example> <note> <para> - <function>array_values</function> a été ajoutée dans PHP 4. + <function>array_values</function> a été ajoutée en PHP 4. Ci dessous, voici une implémentation pour ceux qui utilisent toujours PHP 3. <example> @@ -1558,12 +1584,12 @@ </title> <programlisting role="php"> <?php -function array_values ($arr) { +function array_values($arr){ $t = array(); - while (list($k, $v) = each ($arr)) { + while (list($k, $v) = each($arr)){ $t[] = $v; - return $t; } + return $t; } ?> </programlisting> @@ -1599,14 +1625,14 @@ <simpara> Si <parameter>func</parameter> a besoin de plus d'un argument, une alerte sera générée pour chaque appel de <parameter>func</parameter>. - Ces alertes sont supprimées en ajoutant le suffixe '@' avant l'appel de + Ces alertes sont supprimées en ajoutant le suffixe '@' avant l'appel de <function>array_walk</function> ou simplement en utilisant <function>error_reporting</function>. </simpara> <note> <para> Si <parameter>func</parameter> doit travailler avec les véritables - valeur du tableau, spécifiez que le premier paramètre de + valeurs du tableau, spécifiez que le premier paramètre de <parameter>func</parameter> doit être passé par référence. Alors, les éléments seront directement modifiés dans le tableau. @@ -1614,11 +1640,11 @@ </note> <note> <para> - Passez les clés et userdata à <parameter>func</parameter> - a été ajouté dans PHP 4.0. + Passer les clés et <parameter>userdata</parameter> à + <parameter>func</parameter> a été ajouté en PHP 4.0. </para> <para> - Dans PHP 4, <function>reset</function> doit être appelés si + En PHP 4, <function>reset</function> doit être appelés si nécessaire, car <function>array_walk</function> ne réinitialise pas automatiquement le tableau. </para> @@ -1628,18 +1654,18 @@ <title>Exemple avec <function>array_walk</function></title> <programlisting role="php"> <?php -$fruits = array ("d"=>"citron", "a"=>"orange", "b"=>"banane", "c"=>"pomme"); -function test_alter (&$item1, $key, $prefix) { + $fruits = array ("d"=>"citron", "a"=>"orange", "b"=>"banane", +"c"=>"pomme"); + function test_alter (&$item1, $key, $prefix) { $item1 = "$prefix: $item1"; -} -function test_print ($item2, $key) { + } + function test_print ($item2, $key) { echo "$key. $item2<br>\n"; -} -array_walk ($fruits, 'test_print'); -reset ($fruits); -array_walk ($fruits, 'test_alter', 'fruit'); -reset ($fruits); -array_walk ($fruits, 'test_print'); + } + array_walk ($fruits, 'test_print'); + reset ($fruits); + array_walk ($fruits, 'test_alter', 'fruit'); + reset ($fruits); + array_walk ($fruits, 'test_print'); ?> </programlisting> </example> @@ -1685,8 +1711,8 @@ </example> Cet exemple va afficher: <computeroutput> - fruits[a] = orange fruits[d] = papaye + fruits[a] = orange fruits[b] = banane fruits[c] = ananas </computeroutput> @@ -1695,10 +1721,17 @@ </para> <para> Voir aussi + <function>array-multisort</function>, <function>asort</function>, + <function>krsort</function>, + <function>ksort</function>, + <function>natsort</function>, + <function>natcasesort</function>, <function>rsort</function>, - <function>ksort</function> et - <function>sort</function>. + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function> et + <function>usort</function>. </para> </refsect1> </refentry> @@ -1724,11 +1757,14 @@ <title>Exemple avec <function>asort</function></title> <programlisting role="php"> <?php -$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas"); -asort($fruits); -for(reset($fruits); $key = key($fruits); next($fruits)) { + $fruits = array( "d"=>"papaye", + "a"=>"orange", + "b"=>"banane", + "c"=>"ananas"); + asort($fruits); + for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; -} + } ?> </programlisting> </example> @@ -1736,18 +1772,25 @@ <computeroutput> fruits[c] = ananas fruits[b] = banane - fruits[d] = papaye fruits[a] = orange + fruits[d] = papaye </computeroutput> Les fruits ont été triés par ordre alphabétique, et leur index respectifs ont été conservé. </para> <para> Voir aussi + <function>array-multisort</function>, <function>arsort</function>, + <function>krsort</function>, + <function>ksort</function>, + <function>natsort</function>, + <function>natcasesort</function>, <function>rsort</function>, - <function>ksort</function> et - <function>sort</function>. + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function> et + <function>usort</function>. </para> </refsect1> </refentry> @@ -1763,8 +1806,7 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>compact</function></funcdef> - <paramdef><parameter>string varname | array - varnames</parameter></paramdef> + <paramdef>string|array <parameter>varname</parameter></paramdef> <paramdef> <parameter><optional>...</optional></parameter> </paramdef> @@ -1788,11 +1830,11 @@ <title>Exemple avec <function>compact</function></title> <programlisting role="php"> <?php -$ville = "San Francisco"; -$etat = "CA"; -$evenement = "SIGGRAPH"; -$location_vars = array("ville", "etat"); -$result = compact("evenement", $location_vars); + $ville = "San Francisco"; + $etat = "CA"; + $evenement = "SIGGRAPH"; + $location_vars = array("ville", "etat"); + $result = compact("evenement", $location_vars); ?> </programlisting> <para> @@ -1806,7 +1848,7 @@ <function>extract</function>. <note> <para> - <function>compact</function> a été ajoutée dans PHP 4.0. + <function>compact</function> a été ajoutée en PHP 4.0. </para> </note> </para> @@ -1831,10 +1873,10 @@ (et tout le reste n'aura qu'un élément). </para> <para> - Retourne 1 si la variable n'est pas un tableau. + <function>count</function> retourne 1 si la variable n'est pas un tableau. </para> <para> - Retourne 0 si la variable n'est pas créée. + <function>count</function> retourne 0 si la variable n'est pas +créée. </para> <para> <warning> @@ -1851,11 +1893,11 @@ <title>Exemple avec <function>count</function></title> <programlisting role="php"> <?php -$a[0] = 1; -$a[1] = 3; -$a[2] = 5; -$result = count ($a); -//$result == 3 + $a[0] = 1; + $a[1] = 3; + $a[2] = 5; + $result = count ($a); + //$result == 3 ?> </programlisting> </example> @@ -1889,7 +1931,7 @@ <function>current</function> ne fait que retourner l'élément courant pointé par le pointeur interne. <function>current</function> ne déplace pas le pointeur. - Si le pointeur est au dela du dernier élément de la liste, + Si le pointeur est au delà du dernier élément de la liste, <function>current</function> retourne <literal>FALSE</literal>. <warning> <para> @@ -1947,8 +1989,8 @@ <title>Exemples avec <function>each</function></title> <programlisting role="php"> <?php -$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); -$bar = each ($foo); + $foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese"); + $bar = each($foo); ?> </programlisting> <para> @@ -1961,8 +2003,8 @@ </itemizedlist> <programlisting role="php"> <?php -$foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); -$bar = each ($foo); + $foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); + $bar = each ($foo); ?> </programlisting> </para> @@ -1987,11 +2029,11 @@ </title> <programlisting role="php"> <?php -echo "Valeurs transmises par la méthode POST:<br>"; -reset ($HTTP_POST_VARS); -while (list ($key, $val) = each ($HTTP_POST_VARS)) { + echo "Valeurs transmises par la méthode POST:<br>"; + reset ($HTTP_POST_VARS); + while (list ($key, $val) = each ($HTTP_POST_VARS)) { echo "$key => $val<br>"; -} + } ?> </programlisting> </example> @@ -2194,10 +2236,10 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>in_array</function></funcdef> + <funcdef>boolean <function>in_array</function></funcdef> <paramdef>mixed <parameter>needle</parameter></paramdef> <paramdef>array <parameter>haystack</parameter></paramdef> - <paramdef>bool <parameter><optional>strict</optional></parameter></paramdef> + <paramdef>boolean <parameter><optional>strict</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2206,8 +2248,8 @@ si il s'y trouve, ou <literal>FALSE</literal> sinon. </para> <para> - Si le troisième paramètre <parameter>strict</parameter> est optionel. S'il - vaut <literal>TRUE</literal> alors <function>in_array</function> + Si le troisième paramètre <parameter>strict</parameter> est + optionnel. S'il vaut <literal>TRUE</literal> alors <function>in_array</function> vérifiera aussi les types du paramètre <parameter>needle</parameter> dans <parameter>haystack</parameter>. </para> @@ -2249,7 +2291,7 @@ </informalexample> <note> <para> - <function>in_array</function> a été ajoutée dans PHP 4.0. + <function>in_array</function> a été ajoutée en PHP 4.0. </para> </note> <para> @@ -2272,7 +2314,7 @@ <funcdef>mixed <function>array_search</function></funcdef> <paramdef>mixed <parameter>needle</parameter></paramdef> <paramdef>array <parameter>haystack</parameter></paramdef> - <paramdef>bool <parameter>strict</parameter></paramdef> + <paramdef>boolean <parameter>strict</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2357,11 +2399,17 @@ </para> <simpara> Voir aussi - <function>asort</function>, + <function>array-multisort</function>, <function>arsort</function>, + <function>asort</function>, <function>ksort</function>, - <function>sort</function> et - <function>rsort</function>. + <function>natsort</function>, + <function>natcasesort</function>, + <function>rsort</function>, + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function> et + <function>usort</function>. </simpara> </refsect1> </refentry> @@ -2411,14 +2459,21 @@ </para> <simpara> Voir aussi - <function>asort</function>, + <function>array-multisort</function>, <function>arsort</function>, - <function>sort</function> et - <function>rsort</function>. + <function>asort</function>, + <function>krsort</function>, + <function>natsort</function>, + <function>natcasesort</function>, + <function>rsort</function>, + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function> et + <function>usort</function>. </simpara> <note> <para> - Le second paramètre a été ajouté dans PHP 4. + Le second paramètre a été ajouté en PHP 4.0. </para> </note> </refsect1> @@ -2543,7 +2598,18 @@ </para> <para> Voir aussi + <function>array-multisort</function>, + <function>arsort</function>, + <function>asort</function>, + <function>krsort</function>, + <function>ksort</function>, + <function>natsort</function>, <function>natcasesort</function>, + <function>rsort</function>, + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function>, + <function>usort</function>, <function>strnatcmp</function> et <function>strnatcasecmp</function>. </para> @@ -2581,8 +2647,17 @@ </para> <para> Voir aussi - <function>sort</function>, + <function>array-multisort</function>, + <function>arsort</function>, + <function>asort</function>, + <function>krsort</function>, + <function>ksort</function>, <function>natsort</function>, + <function>rsort</function>, + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function>, + <function>usort</function>, <function>strnatcmp</function> et <function>strnatcasecmp</function>. </para> @@ -2795,10 +2870,16 @@ </para> <para> Voir aussi + <function>array-multisort</function>, <function>arsort</function>, <function>asort</function>, + <function>krsort</function>, <function>ksort</function>, - <function>sort</function> et + <function>natsort</function>, + <function>natcasesort</function>, + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function> et <function>usort</function>. </para> </refsect1> @@ -2835,11 +2916,17 @@ </para> <para> Voir aussi + <function>array-multisort</function>, <function>arsort</function>, <function>asort</function>, + <function>krsort</function>, <function>ksort</function>, + <function>natsort</function>, + <function>natcasesort</function>, <function>rsort</function>, - <function>sort</function> et + <function>sort</function>, + <function>uasort</function>, + <function>uksort</function> et <function>usort</function>. </para> </refsect1> @@ -2905,10 +2992,16 @@ </para> <para> Voir aussi + <function>array-multisort</function>, <function>arsort</function>, <function>asort</function>, + <function>krsort</function>, <function>ksort</function>, - <function>rsort</function> et + <function>natsort</function>, + <function>natcasesort</function>, + <function>rsort</function>, + <function>uasort</function>, + <function>uksort</function> et <function>usort</function>. </para> </refsect1> @@ -2985,12 +3078,17 @@ </para> <para> Voir aussi + <function>array-multisort</function>, <function>arsort</function>, <function>asort</function>, - <function>uasort</function>, + <function>krsort</function>, <function>ksort</function>, - <function>rsort</function> et - <function>sort</function>. + <function>natsort</function>, + <function>natcasesort</function>, + <function>rsort</function>, + <function>sort</function>, + <function>uasort</function> et + <function>usort</function>. </para> </refsect1> </refentry> @@ -3063,11 +3161,17 @@ </para> <para> Voir aussi + <function>array-multisort</function>, <function>arsort</function>, <function>asort</function>, + <function>krsort</function>, <function>ksort</function>, - <function>rsort</function> et - <function>sort</function>. + <function>natsort</function>, + <function>natcasesort</function>, + <function>rsort</function>, + <function>sort</function>, + <function>uasort</function> et + <function>uksort</function>. </para> </refsect1> </refentry>