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>