cvs: phpdoc-fr /reference/array reference.xml /reference/array/functions array-change-key-case.xml array-chunk.xml array-count-values.xml
array-diff.xml array-fill.xml array-filter.xml array-flip.xml array-intersect.xml array-key-exists.xml array-keys.xml array-map.xml array-merge.xml
array-multisort.xml array-pad.xml array-pop.xml array-push.xml array-rand.xml array-reduce.xml array-reverse.xml array-search.xml array-shift.xml
array-slice.xml array-splice.xml array-sum.xml array-unique.xml array-unshift.xml array-values.xml array-walk.xml array.xml arsort.xml asort.xml
compact.xml count.xml each.xml end.xml extract.xml in-array.xml krsort.xml ksort.xml list.xml natcasesort.xml natsort.xml range.xml rsort.xml
shuffle.xml sizeof.xml sort.xml uasort.xml uksort.xml usort.xml

From: Date: Tue, 04 Feb 2003 17:46:07 +0000
Subject: cvs: phpdoc-fr /reference/array reference.xml /reference/array/functions array-change-key-case.xml array-chunk.xml array-count-values.xml
array-diff.xml array-fill.xml array-filter.xml array-flip.xml array-intersect.xml array-key-exists.xml array-keys.xml array-map.xml array-merge.xml
array-multisort.xml array-pad.xml array-pop.xml array-push.xml array-rand.xml array-reduce.xml array-reverse.xml array-search.xml array-shift.xml
array-slice.xml array-splice.xml array-sum.xml array-unique.xml array-unshift.xml array-values.xml array-walk.xml array.xml arsort.xml asort.xml
compact.xml count.xml each.xml end.xml extract.xml in-array.xml krsort.xml ksort.xml list.xml natcasesort.xml natsort.xml range.xml rsort.xml
shuffle.xml sizeof.xml sort.xml uasort.xml uksort.xml usort.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-202@lists.php.net to get a copy of this message
dams Tue Feb 4 12:46:07 2003 EDT Modified files: /phpdoc-fr/reference/array reference.xml /phpdoc-fr/reference/array/functions array-change-key-case.xml array-chunk.xml array-count-values.xml array-diff.xml array-fill.xml array-filter.xml array-flip.xml array-intersect.xml array-key-exists.xml array-keys.xml array-map.xml array-merge.xml array-multisort.xml array-pad.xml array-pop.xml array-push.xml array-rand.xml array-reduce.xml array-reverse.xml array-search.xml array-shift.xml array-slice.xml array-splice.xml array-sum.xml array-unique.xml array-unshift.xml array-values.xml array-walk.xml array.xml arsort.xml asort.xml compact.xml count.xml each.xml end.xml extract.xml in-array.xml krsort.xml ksort.xml list.xml natcasesort.xml natsort.xml range.xml rsort.xml shuffle.xml sizeof.xml sort.xml uasort.xml uksort.xml usort.xml Log: early spring cleaning

Index: phpdoc-fr/reference/array/reference.xml diff -u phpdoc-fr/reference/array/reference.xml:1.4 phpdoc-fr/reference/array/reference.xml:1.5 --- phpdoc-fr/reference/array/reference.xml:1.4 Thu Nov 21 21:26:08 2002 +++ phpdoc-fr/reference/array/reference.xml Tue Feb 4 12:46:03 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.array"> <title>Tableaux</title> <titleabbrev>Tableaux</titleabbrev> <partintro> <section id="array.intro"> - <title>Introduction</title> + &reftitle.intro; <simpara> Ces fonctions vous permettent de manipuler et de traiter les tableaux de nombreuses fa&ccedil;ons. Les tableaux sont tr&egrave;s efficaces Index: phpdoc-fr/reference/array/functions/array-change-key-case.xml diff -u phpdoc-fr/reference/array/functions/array-change-key-case.xml:1.2 phpdoc-fr/reference/array/functions/array-change-key-case.xml:1.3 --- phpdoc-fr/reference/array/functions/array-change-key-case.xml:1.2 Sun Sep 8 17:42:06 2002 +++ phpdoc-fr/reference/array/functions/array-change-key-case.xml Tue Feb 4 12:46:04 2003 @@ -40,11 +40,13 @@ L'exemple ci-dessus va afficher : <informalexample> <programlisting> +<![CDATA[ Array ( [PREMIER] => 1 [SECOND] => 2 ) +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/array/functions/array-chunk.xml diff -u phpdoc-fr/reference/array/functions/array-chunk.xml:1.2 phpdoc-fr/reference/array/functions/array-chunk.xml:1.3 --- phpdoc-fr/reference/array/functions/array-chunk.xml:1.2 Sun Sep 8 17:42:06 2002 +++ phpdoc-fr/reference/array/functions/array-chunk.xml Tue Feb 4 12:46:04 2003 @@ -45,6 +45,7 @@ L'exemple ci-dessus va afficher : <informalexample> <programlisting> +<![CDATA[ Array ( [0] => Array @@ -85,6 +86,7 @@ ) ) +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/array/functions/array-count-values.xml diff -u phpdoc-fr/reference/array/functions/array-count-values.xml:1.2 phpdoc-fr/reference/array/functions/array-count-values.xml:1.3 --- phpdoc-fr/reference/array/functions/array-count-values.xml:1.2 Sun Sep 8 17:42:06 2002 +++ phpdoc-fr/reference/array/functions/array-count-values.xml Tue Feb 4 12:46:05 2003 @@ -24,12 +24,24 @@ <![CDATA[ <?php $array = array(1, "bonjour", 1, "monde", "bonjour"); - array_count_values($array); - // retourne array(1=>2, "bonjour"=>2, "monde"=>1) + print_r(array_count_values($array)); ?> ]]> </programlisting> - </example> + Le r&eacute;sultat du programme ci-dessus est : + <screen> +<![CDATA[ +Array +( + [1] => 2 + [bonjour] => 2 + [monde] => 1 +) +]]> + </screen> + </example> + </para> + <para> <note> <para> <function>array_count_values</function> a &eacute;t&eacute; ajout&eacute;e Index: phpdoc-fr/reference/array/functions/array-diff.xml diff -u phpdoc-fr/reference/array/functions/array-diff.xml:1.2 phpdoc-fr/reference/array/functions/array-diff.xml:1.3 --- phpdoc-fr/reference/array/functions/array-diff.xml:1.2 Sun Sep 8 17:42:06 2002 +++ phpdoc-fr/reference/array/functions/array-diff.xml Tue Feb 4 12:46:05 2003 @@ -26,8 +26,8 @@ <programlisting role="php"> <![CDATA[ <?php - $array1 = array ("a" =&gt; "vert", "rouge", "bleu", "rouge"); - $array2 = array ("b" =&gt; "vert", "jaune", "rouge"); + $array1 = array ("a" => "vert", "rouge", "bleu", "rouge"); + $array2 = array ("b" => "vert", "jaune", "rouge"); $result = array_diff ($array1, $array2); ?> ]]> Index: phpdoc-fr/reference/array/functions/array-fill.xml diff -u phpdoc-fr/reference/array/functions/array-fill.xml:1.2 phpdoc-fr/reference/array/functions/array-fill.xml:1.3 --- phpdoc-fr/reference/array/functions/array-fill.xml:1.2 Sun Sep 8 17:42:06 2002 +++ phpdoc-fr/reference/array/functions/array-fill.xml Tue Feb 4 12:46:05 2003 @@ -27,20 +27,25 @@ <![CDATA[ <?php $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"; -*/ + print_r($a); ?> ]]> </programlisting> + <para> + <varname>$a</varname> vaut : + <screen> +<![CDATA[ +Array +( + [5] => banane + [6] => banane + [7] => banane + [8] => banane + [9] => banane + [10] => banane +)]]> + </screen> + </para> </example> </para> </refsect1> Index: phpdoc-fr/reference/array/functions/array-filter.xml diff -u phpdoc-fr/reference/array/functions/array-filter.xml:1.2 phpdoc-fr/reference/array/functions/array-filter.xml:1.3 --- phpdoc-fr/reference/array/functions/array-filter.xml:1.2 Sun Sep 8 17:42:07 2002 +++ phpdoc-fr/reference/array/functions/array-filter.xml Tue Feb 4 12:46:05 2003 @@ -8,11 +8,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>array_filter</methodname> - <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>callback</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>array_filter</methodname> + <methodparam><type>array</type><parameter>input</parameter></methodparam> + <methodparam choice="opt"><type>callback</type><parameter>function</parameter></methodparam> + </methodsynopsis> <para> <function>array_filter</function> retourne un tableau contenant les &eacute;l&eacute;ments du tableau <parameter>input</parameter>, @@ -26,27 +26,53 @@ <programlisting role="php"> <![CDATA[ <?php - function pair($var) { - return ($var % 2 == 1); - } - function impair($var) { - return ($var % 2 == 0); - } - $array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); - $array2 = array(6, 7, 8, 9, 10, 11, 12); - $tableau_pair = array_filter($array1, "pair"); - $tableau_impair = array_filter($array2, "impair"); +function impair($var) { + return ($var % 2 == 1); +} + +function pair($var) { + return ($var % 2 == 0); +} + +$array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); +$array2 = array (6, 7, 8, 9, 10, 11, 12); + +echo "Impairs :\n"; +print_r(array_filter($array1, "impair")); +echo "Pairs :\n"; +print_r(array_filter($array2, "pair")); ?> ]]> </programlisting> - </example> + <para> + Le programme ci-dessus va afficher : + <screen role="php"> +<![CDATA[ +Impairs : +Array +( + [a] => 1 + [c] => 3 + [e] => 5 +) +Pairs : +Array +( + [0] => 6 + [2] => 8 + [4] => 10 + [6] => 12 +) +]]> + </screen> + </para> + </example> </para> <para> - Cet exemple montre comment extraire les nombres pairs - dans <varname>$tableau_impair</varname> : ce dernier contient - <literal>array ("a"=&gt;1, "c"=&gt;3, "e"=&gt;5);</literal>, - et les nombres impairs dans <varname>$tableau_pair</varname> : - ce dernier contient <literal>array (6, 8, 10, 12);</literal>, + La fonction appel&eacute;e ne doit pas modifier le tableau lui-m&ecirc;me, + c'est &agrave; dire ajouter ou supprimer une valeur. Si des &eacute;l&eacute;ments + sont modifi&eacute;s, le comportement de <function>array_filter</function> + est und&eacute;fini. </para> <para> Voir aussi Index: phpdoc-fr/reference/array/functions/array-flip.xml diff -u phpdoc-fr/reference/array/functions/array-flip.xml:1.2 phpdoc-fr/reference/array/functions/array-flip.xml:1.3 --- phpdoc-fr/reference/array/functions/array-flip.xml:1.2 Sun Sep 8 17:42:07 2002 +++ phpdoc-fr/reference/array/functions/array-flip.xml Tue Feb 4 12:46:05 2003 @@ -59,18 +59,24 @@ <?php $trans = array ("a" => 1, "b" => 1, "c" => 2); $trans = array_flip ($trans); -// et $trans vaut : array(1 => "b", 2 => "c"); + print_r($trans); ?> ]]> </programlisting> + <para> + maintenant <varname>$trans</varname> vaut : + <screen> +<![CDATA[ +Array +( + [1] => b + [2] => c +) +]]> + </screen> + </para> </example> </para> - <note> - <para> - <function>array_flip</function> a &eacute;t&eacute; ajout&eacute;e - en PHP 4.0. - </para> - </note> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-intersect.xml diff -u phpdoc-fr/reference/array/functions/array-intersect.xml:1.2 phpdoc-fr/reference/array/functions/array-intersect.xml:1.3 --- phpdoc-fr/reference/array/functions/array-intersect.xml:1.2 Sun Sep 8 17:42:07 2002 +++ phpdoc-fr/reference/array/functions/array-intersect.xml Tue Feb 4 12:46:05 2003 @@ -20,38 +20,45 @@ qui sont pr&eacute;sentes dans tous les autres arguments. Notez que les cl&eacute;s sont pr&eacute;serv&eacute;es. </para> + <para> + <example> + <title>Exemple avec <function>array_intersect</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $array1 = array ("a" => "vert", "rouge", "bleu"); + $array2 = array ("b" => "vert", "jaune", "rouge"); + $result = array_intersect ($array1, $array2); + print_r($result); +?> +]]> + </programlisting> + <para> + <varname>$result</varname> vaut : + <screen role="php"> +<![CDATA[ +Array +( + [a] => vert + [0] => rouge +) +]]> + </screen> + </para> + </example> + </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 : + 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?... --> + Cette fonction &eacute;tait boguŽe en PHP 4.0.4! </simpara> </warning> - <para> - <example> - <title>Exemple avec <function>array_intersect</function></title> - <programlisting role="php"> -<![CDATA[ -<?php - $array1 = array ("a" => "vert", "rouge", "bleu"); - $array2 = array ("b" => "vert", "jaune", "rouge"); - $result = array_intersect ($array1, $array2); -?> -]]> - </programlisting> - </example> - </para> - <para> - <varname>$result</varname> contient <literal>array ("a" =&gt; "vert", - "rouge");</literal>. - </para> <para> Voir aussi <function>array_diff</function>. Index: phpdoc-fr/reference/array/functions/array-key-exists.xml diff -u phpdoc-fr/reference/array/functions/array-key-exists.xml:1.1 phpdoc-fr/reference/array/functions/array-key-exists.xml:1.2 --- phpdoc-fr/reference/array/functions/array-key-exists.xml:1.1 Mon Oct 14 19:03:17 2002 +++ phpdoc-fr/reference/array/functions/array-key-exists.xml Tue Feb 4 12:46:05 2003 @@ -23,19 +23,20 @@ <example> <title>Exemple avec <function>array_key_exists</function></title> <programlisting role="php"> +<![CDATA[ <?php $search_array = array("premier" => 1, "second" => 4); if (array_key_exists("premier", $search_array)) { echo "L'&eacute;l&eacute;ment 'premier' existe dans le tableau"; } ?> +]]> </programlisting> </example> </para> <note> <simpara> - Cette fonction s'appelait <function>key_exists</function> - en PHP version 4.0.6. + Cette fonction s'appelait <function>key_exists</function> en PHP version 4.0.6. </simpara> </note> <para> Index: phpdoc-fr/reference/array/functions/array-keys.xml diff -u phpdoc-fr/reference/array/functions/array-keys.xml:1.1 phpdoc-fr/reference/array/functions/array-keys.xml:1.2 --- phpdoc-fr/reference/array/functions/array-keys.xml:1.1 Sun Apr 14 20:21:58 2002 +++ phpdoc-fr/reference/array/functions/array-keys.xml Tue Feb 4 12:46:05 2003 @@ -11,13 +11,11 @@ <methodsynopsis> <type>array</type><methodname>array_keys</methodname> <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter> - search_value - </parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>search_value</parameter></methodparam> </methodsynopsis> <para> <function>array_keys</function> retourne les cl&eacute;s num&eacute;riques - et lit&eacute;rales du tableau <parameter>input</parameter>. + et litt&eacute;rales du tableau <parameter>input</parameter>. </para> <para> Si l'option <parameter>search_value</parameter> est sp&eacute;cifi&eacute;e, @@ -29,43 +27,68 @@ <example> <title>Exemple avec <function>array_keys</function></title> <programlisting role="php"> -&lt;?php - $array = array(0 =&gt; 100, "couleur" =&gt; "rouge"); - array_keys($array); -// retourne array(0, "couleur") - $array = array("bleu", "rouge", "vert", "bleu", "bleu"); - array_keys($array, "bleu"); -// retourne array(0, 3, 4) - $array = array( "couleur" =&gt; array("bleu", "rouge", "vert"), - "taille" =&gt; array("petit", "moyen", "grand") ); - array_keys($array); -// retourne array("couleur", "taille") -?&gt; +<![CDATA[ +<?php + $array = array (0 => 100, "couleur" => "rouge"); + print_r(array_keys ($array)); + + $array = array ("bleu", "rouge", "vert", "bleu", "bleu"); + print_r(array_keys ($array, "bleu")); + + $array = array ("couleur" => array("bleu", "rouge", "vert"), "taille" => array("petit", "moyen", "grand")); + print_r(array_keys ($array)); +?> +]]> </programlisting> - </example> + <para> + Le rŽsultat du script d'exemple est : + <screen> +<![CDATA[ +Array +( + [0] => 0 + [1] => couleur +) +Array +( + [0] => 0 + [1] => 3 + [2] => 4 +) +Array +( + [0] => couleur + [1] => taille +) +]]> + </screen> + </para> + </example> </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 - les utilisateurs de PHP 3 + les utilisateurs de PHP 3 </title> <programlisting role="php"> -&lt;?php - function array_keys ($arr, $term="") { +<![CDATA[ +<?php +function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { - if ($term &amp;&amp; $v != $term) { + if ($term && $v != $term) { continue; - $t[] = $k; } - return $t; - } - } -?&gt; + $t[] = $k; + } + return $t; +} +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/array/functions/array-map.xml diff -u phpdoc-fr/reference/array/functions/array-map.xml:1.1 phpdoc-fr/reference/array/functions/array-map.xml:1.2 --- phpdoc-fr/reference/array/functions/array-map.xml:1.1 Sun Apr 14 20:21:58 2002 +++ phpdoc-fr/reference/array/functions/array-map.xml Tue Feb 4 12:46:05 2003 @@ -26,146 +26,186 @@ <example> <title>Exemple avec <function>array_map</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php function cube($n) { return $n*$n*$n; } $a = array(1, 2, 3, 4, 5); $b = array_map("cube", $a); -?&gt; +?> +]]> </programlisting> + <para> + Cela conduit &agrave; ce que la variable <varname>$b</varname> contienne : + <screen> +<![CDATA[ +Array +( + [0] => 1 + [1] => 8 + [2] => 27 + [3] => 64 + [4] => 125 +) +]]> + </screen> + </para> </example> </para> <para> - Avec cet exemple, la variable <varname>$b</varname> contiendra - <literal>array (1, 8, 27, 64, 125);</literal>. - </para> - <para> <example> <title><function>array_map</function> - utilisation de plusieurs tableaux</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php function parle_espagnol($n, $m) { return "Le nombre $n se dit $m en espagnol"; } + function map_espagnol($n, $m) { return array($n => $m); } + $a = array(1, 2, 3, 4, 5); $b = array("uno", "dos", "tres", "cuatro", "cinco"); $c = array_map("parle_espagnol", $a, $b); print_r($c); -// Affichera : -// Array -// ( -// [0] => Le nombre 1 se dit uno en espagnol -// [1] => Le nombre 2 se dit dos en espagnol -// [2] => Le nombre 3 se dit tres en espagnol -// [3] => Le nombre 4 se dit cuatro en espagnol -// [4] => Le nombre 5 se dit cinco en espagnol -// ) - $d = array_map("map_espagnol", $a , $b); - print_r($d); -// Affichera : -// Array -// ( -// [0] => Array -// ( -// [1] => uno -// ) -// -// [1] => Array -// ( -// [2] => dos -// ) -// -// [2] => Array -// ( -// [3] => tres -// ) -// -// [3] => Array -// ( -// [4] => cuatro -// ) -// -// [4] => Array -// ( -// [5] => cinco -// ) -// -// ) -?&gt; - </programlisting> - </example> - </para> - <para> - G&eacute;n&eacute;ralement, lorsque vous utilisez plusieurs tableaux, ils doivent - &ecirc;tre de m&ecirc;me longueur, car la fonction de callback est appliqu&eacute; &agrave; - un &eacute;l&eacute;ment de chaque tableau. Si les tableaux sont de taille in&eacute;gale, - les plus petits seront compl&eacute;t&eacute;s avec des &eacute;l&eacute;ments vides. - </para> - <para> - Une utilisation interessante de cette fonction est de construire des - tableaux de tableaux, gr&acirc;ce &agrave; la fonction de callback &null;. - </para> - <para> - <example> - <title><function>array_map</function> - cr&eacute;ation d'un tableau de tableaux</title> - <programlisting role="php"> -&lt;?php - $a = array(1, 2, 3, 4, 5); - $b = array("un", "deux", "trois", "quatre", "cinq"); - $c = array("uno", "dos", "tres", "cuatro", "cinco"); - $d = array_map(null, $a, $b, $c); - print_r($d); -// affichera : -// Array -// ( -// [0] => Array -// ( -// [0] => 1 -// [1] => un -// [2] => uno -// ) -// -// [1] => Array -// ( -// [0] => 2 -// [1] => deux -// [2] => dos -// ) -// -// [2] => Array -// ( -// [0] => 3 -// [1] => trois -// [2] => tres -// ) -// -// [3] => Array -// ( -// [0] => 4 -// [1] => quatre -// [2] => cuatro -// ) -// -// [4] => Array -// ( -// [0] => 5 -// [1] => cinq -// [2] => cinco -// ) -// -// ) -?&gt; - </programlisting> - </example> - </para> - <para> +?> +]]> + </programlisting> + <para> + Cela va afficher : + <screen> +<![CDATA[ +// Contenu de $c +Array +( + [0] => Le nombre 1 se dit uno en espagnol + [1] => Le nombre 2 se dit dos en espagnol + [2] => Le nombre 3 se dit tres en espagnol + [3] => Le nombre 4 se dit cuatro en espagnol + [4] => Le nombre 5 se dit cinco en espagnol +) + +// Contenu de $d +Array +( + [0] => Array + ( + [1] => uno + ) + + [1] => Array + ( + [2] => dos + ) + + [2] => Array + ( + [3] => tres + ) + + [3] => Array + ( + [4] => cuatro + ) + + [4] => Array + ( + [5] => cinco + ) + +) +]]> + </screen> + </para> + </example> + </para> + <para> + G&eacute;n&eacute;ralement, lors de l'utilisation de plusieurs tableaux, ils doivent + &ecirc;tre d'&eacute;gale longueur, car la fonction de callback est appliqu&eacute; de mani&egrave;re + similaire &agrave; tous les tableaux. Si les tableaux sont de taille in&eacute;gales, + les plus petits seront compl&eacute;t&eacute;s avec des &eacute;l&eacute;ments vides. + </para> + <para> + Une utilisation interessante de cette fonction est la construction + de tableaux de tableaux, facilement r&eacute;alis&eacute; en passant la valeur + &null; comme nom de fonction de callback. + </para> + <para> + <example> + <title>Cr&eacute;ation d'un tableau de tableaux</title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = array(1, 2, 3, 4, 5); +$b = array("one", "two", "three", "four", "five"); +$c = array("uno", "dos", "tres", "cuatro", "cinco"); +$d = array("un", "deux","trois","quatre","cinq"); + +$d = array_map(null, $a, $b, $c, $d); +print_r($d); +?> +]]> + </programlisting> + </example> + </para> + <para> + Le programme ci-dessus va afficher : + <screen> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => 1 + [1] => one + [2] => uno + [3] => un + ) + + [1] => Array + ( + [0] => 2 + [1] => two + [2] => dos + [3] => deux + ) + + [2] => Array + ( + [0] => 3 + [1] => three + [2] => tres + [3] => trois + ) + + [3] => Array + ( + [0] => 4 + [1] => four + [2] => cuatro + [3] => quatre + ) + + [4] => Array + ( + [0] => 5 + [1] => five + [2] => cinco + [3] => cinq + ) + +) +]]> + </screen> + </para> + <para> Voir aussi - <function>array_filter</function> et - <function>array_reduce</function>. + <function>array_filter</function>, + <function>array_reduce</function> et + <function>array_walk</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-merge.xml diff -u phpdoc-fr/reference/array/functions/array-merge.xml:1.1 phpdoc-fr/reference/array/functions/array-merge.xml:1.2 --- phpdoc-fr/reference/array/functions/array-merge.xml:1.1 Sun Apr 14 20:21:59 2002 +++ phpdoc-fr/reference/array/functions/array-merge.xml Tue Feb 4 12:46:05 2003 @@ -29,26 +29,94 @@ <example> <title>Exemple avec <function>array_merge</function></title> <programlisting role="php"> -&lt;?php - $array1 = array ("couleur" =&gt; "rouge", 2, 4); - $array2 = array ("a", "b", "couleur" =&gt; "vert", "forme" =&gt; "trap&eacute;zo&iuml;de"); - array_merge ($array1, $array2); -?&gt; +<![CDATA[ +<?php + $array1 = array ("couleur" => "rouge", 2, 4); + $array2 = array ("a", "b", "couleur" => "vert", "forme" => "trap&eacute;zo&iuml;de"); + $result = array_merge ($array1, $array2); + print_r($result); +?> +]]> </programlisting> - <para> - Le r&eacute;sultat sera array("couleur" =&gt; "vert", 2, 4, "a", - "b", "forme" =&gt; "trap&eacute;zo&icirc;de"). - </para> + <para> + The <varname>$result</varname> vaut : + <screen role="php"> +<![CDATA[ +Array +( + [couleur] => vert + [0] => 2 + [1] => 4 + [2] => a + [3] => b + [forme] => trap&eacute;zo&iuml;de +) +]]> + </screen> + </para> </example> + </para> + <para> + <example> + <title>Exemple avec <function>array_merge</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $array1 = array(); + $array2 = array(1 => "data"); + $result = array_merge($array1, $array2); +?> +]]> + </programlisting> + <para> + N'oubliez pas que les index numŽriques seront renumŽrotŽs. + <screen role="php"> +<![CDATA[ +Array +( + [0] => data +) +]]> + </screen> + </para> + <para> + Si vous voulez prŽserver complŽtement les tableaux, et que + vous souhaitez simplement les ajouter les uns aux autres, + utilisez l'opŽrateur <literal>+</literal> : + <programlisting role="php"> +<![CDATA[ +<?php + $array1 = array(); + $array2 = array(1 => "data"); + $result = $array1 + $array2; +?> +]]> + </programlisting> + Les index numŽriques seront prŽservŽs. D'o le rŽsultat : + <screen role="php"> +<![CDATA[ +Array +( + [1] => data +) +]]> + </screen> + </para> + </example> + </para> <note> <para> - <function>array_merge</function> a &eacute;t&eacute; ajout&eacute;e dans - PHP 4.0. + Les clŽs communes seront ŽcrasŽes successivement par les clŽs identiques + suivantes. </para> </note> - </para> - </refsect1> - </refentry> + <para> + Voir aussi + <function>array_merge_recursive</function>. + </para> + </refsect1> + </refentry> + <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/reference/array/functions/array-multisort.xml diff -u phpdoc-fr/reference/array/functions/array-multisort.xml:1.1 phpdoc-fr/reference/array/functions/array-multisort.xml:1.2 --- phpdoc-fr/reference/array/functions/array-multisort.xml:1.1 Sun Apr 14 20:21:59 2002 +++ phpdoc-fr/reference/array/functions/array-multisort.xml Tue Feb 4 12:46:06 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>array_multisort</methodname> + <type>bool</type><methodname>array_multisort</methodname> <methodparam><type>array</type><parameter>ar1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> @@ -38,10 +38,10 @@ Options de tri : <itemizedlist> <listitem> - <simpara>SORT_ASC - Tri en ordre ascendant</simpara> + <simpara><constant>SORT_ASC</constant> - Tri en ordre ascendant</simpara> </listitem> <listitem> - <simpara>SORT_DESC - Tri en ordre descendant</simpara> + <simpara><constant>SORT_DESC</constant> - Tri en ordre descendant</simpara> </listitem> </itemizedlist> </para> @@ -49,13 +49,13 @@ Options de type de tri: <itemizedlist> <listitem> - <simpara>SORT_REGULAR - Comparaison normale des valeurs</simpara> + <simpara><constant>SORT_REGULAR</constant> - Comparaison normale des valeurs</simpara> </listitem> <listitem> - <simpara>SORT_NUMERIC - Comparaison num&eacute;rique des valeurs</simpara> + <simpara><constant>SORT_NUMERIC</constant> - Comparaison num&eacute;rique des valeurs</simpara> </listitem> <listitem> - <simpara>SORT_STRING - Comparaison alphab&eacute;tique des valeurs</simpara> + <simpara><constant>SORT_STRING</constant> - Comparaison alphab&eacute;tique des valeurs</simpara> </listitem> </itemizedlist> </para> @@ -65,19 +65,20 @@ pr&eacute;c&eacute;dent. Tous les autres sont mis par d&eacute;faut &agrave; SORT_ASC et SORT_REGULAR. </para> - <para> - <function>array_multisort</function> retourne &true; - en cas de succ&egrave;s, &false; sinon. - </para> + <para> + &return.success; + </para> <para> <example> <title>Trier plusieurs tableaux</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $ar1 = array ("10", 100, 100, "a"); $ar2 = array (1, 3, "2", 1); array_multisort ($ar1, $ar2); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -92,11 +93,13 @@ <example> <title>Classer un tableau multidimensionnel</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); - array_multisort ($ar[0], SORT_ASC, SORT_STRING, + array_multisort($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC); -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/array/functions/array-pad.xml diff -u phpdoc-fr/reference/array/functions/array-pad.xml:1.1 phpdoc-fr/reference/array/functions/array-pad.xml:1.2 --- phpdoc-fr/reference/array/functions/array-pad.xml:1.1 Sun Apr 14 20:22:00 2002 +++ phpdoc-fr/reference/array/functions/array-pad.xml Tue Feb 4 12:46:06 2003 @@ -32,7 +32,8 @@ <example> <title>Exemple avec <function>array_pad</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $input = array(12, 10, 9); $result = array_pad($input, 5, 0); // Le r&eacute;sultat est array (12, 10, 9, 0, 0) @@ -40,7 +41,8 @@ // Le r&eacute;sultat est array (-1, -1, -1, -1, 12, 10, 9) $result = array_pad($input, 2, "noop"); // pas compl&eacute;t&eacute; -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/array/functions/array-pop.xml diff -u phpdoc-fr/reference/array/functions/array-pop.xml:1.1 phpdoc-fr/reference/array/functions/array-pop.xml:1.2 --- phpdoc-fr/reference/array/functions/array-pop.xml:1.1 Sun Apr 14 20:22:00 2002 +++ phpdoc-fr/reference/array/functions/array-pop.xml Tue Feb 4 12:46:06 2003 @@ -25,27 +25,35 @@ <example> <title>Exemple avec <function>array_pop</function></title> <programlisting role="php"> -&lt;?php - $stack = array("orange", "pomme", "framboise"); +<![CDATA[ +<?php + $stack = array("orange", "banane", "pomme", "framboise"); $fruit = array_pop($stack); -?&gt; +?> +]]> </programlisting> <para> - Apr&egrave;s ceci, $stack n'a plus que 2 &eacute;l&eacute;ments: "orange" et "pomme", - tandis que $fruit contient "framboise". + Apr&egrave;s ceci, $stack n'a plus que 2 &eacute;l&eacute;ments: "orange" et "pomme" : + <screen role="php"> +<![CDATA[ +Array +( + [0] => orange + [1] => banana + [2] => apple +) +]]> + </screen> </para> + tandis que $fruit contient "framboise". </example> </para> + &return.falseproblem; <para> Voir aussi <function>array_push</function>, <function>array_shift</function> et <function>array_unshift</function>. - <note> - <para> - <function>array_pop</function> a &eacute;t&eacute; ajout&eacute;e en PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-push.xml diff -u phpdoc-fr/reference/array/functions/array-push.xml:1.1 phpdoc-fr/reference/array/functions/array-push.xml:1.2 --- phpdoc-fr/reference/array/functions/array-push.xml:1.1 Sun Apr 14 20:22:00 2002 +++ phpdoc-fr/reference/array/functions/array-push.xml Tue Feb 4 12:46:06 2003 @@ -23,9 +23,11 @@ La longueur du tableau <parameter>array</parameter> augmente d'autant. Cela a le m&ecirc;me effet que : <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $array[] = $var; -?&gt; +?> +]]> </programlisting> repet&eacute; pour chaque <parameter>var</parameter>. </para> @@ -33,29 +35,39 @@ <function>array_push</function> retourne le nouveau nombre d'&eacute;l&eacute;ments du tableau. </para> - <para> - <example> - <title>Exemple avec <function>array_push</function></title> - <programlisting role="php"> -&lt;?php - $stack = array (1, 2); - array_push($stack, "+", 3); -?&gt; - </programlisting> - </example> - Cet exemple fait que $stack a 4 &eacute;l&eacute;ments: 1, 2, "+", - et 3. - </para> + <para> + <example> + <title>Exemple avec <function>array_push</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $stack = array ("orange", "banane"); + array_push ($stack, "pomme", "bleuet"); + print_r($stack); +?> +]]> + </programlisting> + <para> + <varname>$stack</varname> vaut alors : + <screen role="php"> +<![CDATA[ +Array +( + [0] => orange + [1] => banane + [2] => pomme + [3] => bleuet +) +]]> + </screen> + </para> + </example> + </para> <para> Voir aussi <function>array_pop</function>, <function>array_shift</function> et <function>array_unshift</function>. - <note> - <para> - <function>array_push</function> a &eacute;t&eacute; ajout&eacute;e en PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-rand.xml diff -u phpdoc-fr/reference/array/functions/array-rand.xml:1.1 phpdoc-fr/reference/array/functions/array-rand.xml:1.2 --- phpdoc-fr/reference/array/functions/array-rand.xml:1.1 Sun Apr 14 20:22:00 2002 +++ phpdoc-fr/reference/array/functions/array-rand.xml Tue Feb 4 12:46:06 2003 @@ -36,13 +36,15 @@ <example> <title>Exemple avec <function>array_rand</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php srand ((double) microtime() * 10000000); $input = array ("Neo", "Morpheus", "Trinit&eacute;e", "Cypher", "Tank"); $rand_keys = array_rand ($input, 2); print $input[$rand_keys[0]]."\n"; print $input[$rand_keys[1]]."\n"; -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/array/functions/array-reduce.xml diff -u phpdoc-fr/reference/array/functions/array-reduce.xml:1.1 phpdoc-fr/reference/array/functions/array-reduce.xml:1.2 --- phpdoc-fr/reference/array/functions/array-reduce.xml:1.1 Sun Apr 14 20:22:00 2002 +++ phpdoc-fr/reference/array/functions/array-reduce.xml Tue Feb 4 12:46:06 2003 @@ -4,18 +4,16 @@ <refentry id="function.array-reduce"> <refnamediv> <refname>array_reduce</refname> - <refpurpose> - R&eacute;duit it&eacute;rativement un tableau - </refpurpose> + <refpurpose>R&eacute;duit it&eacute;rativement un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>array_reduce</methodname> - <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>initial</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>array_reduce</methodname> + <methodparam><type>array</type><parameter>input</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>initial</parameter></methodparam> + </methodsynopsis> <para> <function>array_reduce</function> applique it&eacute;rativement la fonction <parameter>callback</parameter> aux &eacute;l&eacute;ments du @@ -29,7 +27,8 @@ <example> <title>Exemple avec <function>array_reduce</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php function rsum($v, $w) { $v += $w; return $v; @@ -43,7 +42,8 @@ $b = array_reduce($a, "rsum"); $c = array_reduce($a, "rmul", 10); $d = array_reduce($x, "rsum", 1); -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/array/functions/array-reverse.xml diff -u phpdoc-fr/reference/array/functions/array-reverse.xml:1.1 phpdoc-fr/reference/array/functions/array-reverse.xml:1.2 --- phpdoc-fr/reference/array/functions/array-reverse.xml:1.1 Sun Apr 14 20:22:01 2002 +++ phpdoc-fr/reference/array/functions/array-reverse.xml Tue Feb 4 12:46:06 2003 @@ -13,7 +13,7 @@ <methodsynopsis> <type>array</type><methodname>array_reverse</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam choice="opt"><type>boolean</type><parameter>preserve_keys</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter></methodparam> </methodsynopsis> <para> <function>array_reverse</function> prend le tableau <parameter>array</parameter> @@ -25,23 +25,50 @@ <example> <title>Exemple avec <function>array_reverse</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $input = array ("php", 4.0, array ("rouge", "vert")); $result = array_reverse ($input); $result_keyed = array_reverse ($input, TRUE); -?&gt; + print_r($result); + print_r($result_keyed); +?> +]]> </programlisting> + <para> + Ce code fait que <varname>$result</varname> et + <varname>$result_keyed</varname> contiennent les mmes + ŽlŽments, mais qu'ils diffrent au niveau des clŽs. + <varname>$result</varname> et + <varname>$result_keyed</varname> contiennent : + <screen role="php"> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => rouge + [1] => vert + ) + + [1] => 4 + [2] => php +) +Array +( + [2] => Array + ( + [0] => rouge + [1] => vert + ) + + [1] => 4 + [0] => php +) +]]> + </screen> + </para> </example> - 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 &eacute;t&eacute; ajout&eacute;e en - PHP 4.0 Beta 3. - </para> - </note> <note> <para> Le second param&egrave;tre <parameter>preserve_keys</parameter> a &eacute;t&eacute; Index: phpdoc-fr/reference/array/functions/array-search.xml diff -u phpdoc-fr/reference/array/functions/array-search.xml:1.1 phpdoc-fr/reference/array/functions/array-search.xml:1.2 --- phpdoc-fr/reference/array/functions/array-search.xml:1.1 Sun Apr 14 20:22:01 2002 +++ phpdoc-fr/reference/array/functions/array-search.xml Tue Feb 4 12:46:06 2003 @@ -10,25 +10,33 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>array_search</methodname> - <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> - <methodparam><type>array</type><parameter>haystack</parameter></methodparam> - <methodparam><type>boolean</type><parameter>strict</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>array_search</methodname> + <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> + <methodparam><type>array</type><parameter>haystack</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam> + </methodsynopsis> <para> <function>array_search</function> recherche <parameter>needle</parameter> dans <parameter>haystack</parameter> et retourne la cl&eacute; associ&eacute;e s'il la trouve, ou &false; sinon. </para> + <note> + <para> + Avant PHP 4.2.0, <function>array_search</function> retournait + &null; em cas d'&eacute;chec, au lieu de &false;. + </para> + </note> <para> Si le troisi&egrave;me param&egrave;tre <parameter>strict</parameter> vaut &true;, alors <function>array_search</function> s'assurera aussi que le type de <parameter>needle</parameter> est le m&ecirc;me que celui de la valeur trouv&eacute;e dans <parameter>haystack</parameter>. </para> + &return.falseproblem; <para> Voir aussi + <function>array_keys</function> et <function>in_array</function>. </para> </refsect1> Index: phpdoc-fr/reference/array/functions/array-shift.xml diff -u phpdoc-fr/reference/array/functions/array-shift.xml:1.1 phpdoc-fr/reference/array/functions/array-shift.xml:1.2 --- phpdoc-fr/reference/array/functions/array-shift.xml:1.1 Sun Apr 14 20:22:01 2002 +++ phpdoc-fr/reference/array/functions/array-shift.xml Tue Feb 4 12:46:06 2003 @@ -26,26 +26,36 @@ <example> <title>Exemple avec <function>array_shift</function></title> <programlisting role="php"> -&lt;?php - $args = array("-v", "-f"); - $opt = array_shift($args); -?&gt; +<![CDATA[ +<?php + $stack = array ("orange", "banane", "pomme", "bleuet"); + $fruit = array_shift ($stack); + print_r($stack); +?> +]]> </programlisting> + <para> + <varname>$stack</varname> contient encore trois ŽlŽments : + <screen role="php"> +<![CDATA[ +Array +( + [0] => banane + [1] => pomme + [2] => bleuet +) +]]> + </screen> + et <literal>orange</literal> a ŽtŽ placŽ dans + <varname>$fruit</varname>. + </para> </example> - Cet exemple aura pour r&eacute;sultat que $args ne contiendra plus que "-f", - et $opt contient "-v". </para> <para> Voir aussi <function>array_unshift</function>, <function>array_push</function> et <function>array_pop</function>. - <note> - <para> - <function>array_shift</function> a &eacute;t&eacute; ajout&eacute;e en PHP - 4.0. - </para> - </note> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-slice.xml diff -u phpdoc-fr/reference/array/functions/array-slice.xml:1.1 phpdoc-fr/reference/array/functions/array-slice.xml:1.2 --- phpdoc-fr/reference/array/functions/array-slice.xml:1.1 Sun Apr 14 20:22:01 2002 +++ phpdoc-fr/reference/array/functions/array-slice.xml Tue Feb 4 12:46:06 2003 @@ -12,9 +12,7 @@ <type>array</type><methodname>array_slice</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - length - </parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> <function>array_slice</function> retourne une s&eacute;rie d' @@ -42,32 +40,24 @@ </para> <para> <example> - <title>Exemple avec <function>array_slice</function></title> + <title>Exemples avec <function>array_slice</function></title> <programlisting role="php"> -&lt;?php - $input = array("a", "b", "c", "d", "e"); - $output = array_slice($input, 2); // retourne "c", "d", et "e" -// les trois exemples suivants sont &eacute;quivalents - $output = array_slice($input, 2, 2); // retourne "c", "d" - $output = array_slice($input, 2, -1); // retourne "c", "d" -// Equivalent &agrave; : - $offset = 2; $length = -1; - $output = array_slice($input, 2, count($input) - $offset + $length); -// retourne "c", "d" - $output = array_slice($input, -2, 1); // retourne "d" - $output = array_slice($input, 0, 3); // retourne "a", "b", et "c" -?&gt; +<![CDATA[ +<?php +$input = array ("a", "b", "c", "d", "e"); + +$output = array_slice ($input, 2); // retourne "c", "d" et "e" +$output = array_slice ($input, 2, -1); // retourne "c", "d" +$output = array_slice ($input, -2, 1); // retourne "d" +$output = array_slice ($input, 0, 3); // retourne "a", "b" et "c" +?> +]]> </programlisting> </example> </para> <para> Voir aussi <function>array_splice</function>. - <note> - <para> - <function>array_slice</function> a &eacute;t&eacute; ajout&eacute;e en PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-splice.xml diff -u phpdoc-fr/reference/array/functions/array-splice.xml:1.1 phpdoc-fr/reference/array/functions/array-splice.xml:1.2 --- phpdoc-fr/reference/array/functions/array-splice.xml:1.1 Sun Apr 14 20:22:01 2002 +++ phpdoc-fr/reference/array/functions/array-splice.xml Tue Feb 4 12:46:06 2003 @@ -62,55 +62,88 @@ </para> <para> Les codes suivants sont &eacute;quivalents : - <programlisting role="php"> -&lt;?php - array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y)) - array_pop($input) array_splice($input, -1) - array_shift($input) array_splice($input, 0, 1) - array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y)) - $a[$x] = $y array_splice($input, $x, 1, $y) -?&gt; - </programlisting> - </para> - <para> - <function>array_splice</function> retourne le tableau des &eacute;l&eacute;ments - supprim&eacute;s. - </para> + <table> + <title>Equivalents de <function>array_splice</function></title> + <tgroup cols="2"> + <tbody> + <row> + <entry> + array_push($input, $x, $y) + </entry> + <entry> + array_splice($input, count($input), 0, array($x, $y)) + </entry> + </row> + <row> + <entry> + array_pop($input) + </entry> + <entry> + array_splice($input, -1) + </entry> + </row> + <row> + <entry> + array_shift($input) + </entry> + <entry> + array_splice($input, -1) + </entry> + </row> + <row> + <entry> + array_unshift($input, $x, $y) + </entry> + <entry> + array_splice($input, 0, 0, array($x, $y)) + </entry> + </row> + <row> + <entry> + $a[$x] = $y + </entry> + <entry> + array_splice($input, $x, 1, $y) + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + <function>array_splice</function> retourne le tableau des &eacute;l&eacute;ments + supprim&eacute;s. + </para> <para> <example> <title>Exemples avec <function>array_splice</function></title> <programlisting role="php"> -&lt;?php -// cas simple - $input = array("rouge", "vert", "bleu", "jaune"); - array_splice($input, 2); -// $input est array("rouge", "vert") -// nombre d'&eacute;l&eacute;ments n&eacute;gatif - $input = array("rouge", "vert", "bleu", "jaune"); - array_splice($input, 1, -1); -// $input est array("rouge", "jaune") -// avec un &eacute;l&eacute;ment de remplacement - $input = array("rouge", "vert", "bleu", "jaune"); - array_splice($input, 1, count($input), "orange"); -// $input est array("rouge", "orange") -// cas complexe - $input = array("rouge", "vert", "bleu", "jaune"); - array_splice($input, -1, 1, array("noir", "marron")); -// $input est array("rouge", "vert", -// "bleu", "noir", "marron") -?&gt; +<![CDATA[ +<?php +$input = array ("rouge", "vert", "bleu", "jaune"); +array_splice ($input, 2); +// $input vaut array ("rouge", "vert") + +$input = array ("rouge", "vert", "bleu", "jaune"); +array_splice ($input, 1, -1); +// $input vaut array ("rouge", "jaune") + +$input = array ("rouge", "vert", "bleu", "jaune"); +array_splice ($input, 1, count($input), "orange"); +// $input vaut array ("rouge", "orange") + +$input = array ("rouge", "vert", "bleu", "jaune"); +array_splice ($input, -1, 1, array("black", "marron")); +// $input vaut array ("rouge", "vert", +// "bleu", "black", "marron") +?> +]]> </programlisting> </example> </para> <para> Voir aussi <function>array_slice</function>. - <note> - <para> - <function>array_splice</function> a &eacute;t&eacute; ajout&eacute;e - en PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-sum.xml diff -u phpdoc-fr/reference/array/functions/array-sum.xml:1.1 phpdoc-fr/reference/array/functions/array-sum.xml:1.2 --- phpdoc-fr/reference/array/functions/array-sum.xml:1.1 Sun Apr 14 20:22:02 2002 +++ phpdoc-fr/reference/array/functions/array-sum.xml Tue Feb 4 12:46:06 2003 @@ -10,10 +10,10 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>array_sum</methodname> - <methodparam><type>array</type><parameter>arr</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>array_sum</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> <para> <function>array_sum</function> retourne la somme des valeurs du tableau, sous forme d'un entier ou d'un @@ -23,17 +23,33 @@ <example> <title>Exemple avec <function>array_sum</function></title> <programlisting role="php"> -&lt;?php - $a = array(2,4,6,8); - echo "somme(a) = ".array_sum($a)."\n"; -// affiche : somme(a) = 20 - $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); - echo "somme(b) = ".array_sum($b)."\n"; -// affiche : somme(b) = 6.9 -?&gt; +<![CDATA[ +$a = array(2, 4, 6, 8); +echo "sum(a) = ".array_sum($a)."\n"; + +$b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); +echo "sum(b) = ".array_sum($b)."\n"; +]]> </programlisting> - </example> - </para> + <para> + Le r&eacute;sultat de ce script sera : + <screen role="php"> +<![CDATA[ +sum(a) = 20 +sum(b) = 6.9 +]]> + </screen> + </para> + </example> + </para> + <note> + <para> + Dans les versions de &php; ant&eacute;rieure &agrave; la version 4.0.6, + cette fonction modifiez le tableau pass&eacute; en argument + et convertissez ses arguments en cha&icirc;nes de caract&egrave;res + (ce qui conduisait g&eacute;n&eacute;ralement &agrave; 0). + </para> + </note> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-unique.xml diff -u phpdoc-fr/reference/array/functions/array-unique.xml:1.1 phpdoc-fr/reference/array/functions/array-unique.xml:1.2 --- phpdoc-fr/reference/array/functions/array-unique.xml:1.1 Sun Apr 14 20:22:02 2002 +++ phpdoc-fr/reference/array/functions/array-unique.xml Tue Feb 4 12:46:06 2003 @@ -40,50 +40,56 @@ <example> <title>Exemple avec <function>array_unique</function></title> <programlisting role="php"> -&lt;?php - $input = array ("a" =&gt; "vert", "rouge", "b" =&gt; "vert", "bleu", "rouge"); +<![CDATA[ +<?php + $input = array ("a" => "vert", "rouge", "b" => "vert", "bleu", "rouge"); $result = array_unique ($input); print_r($result); -// Cela va afficher : -//Array -//( -// [a] => vert -// [0] => rouge -// [1] => bleu -//) -?&gt; +?> +]]> </programlisting> + <para> + Cela va afficher : + <screen role="php"> +<![CDATA[ +Array +( + [a] => vert + [0] => rouge + [1] => bleu +) +]]> + </screen> + </para> </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; - cons&eacute;quence, sauf si votre tableau contient des nombres, qui - 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> <programlisting role="php"> -&lt;?php - $input = array(4,"3",3,"4",4,4); - $result = array_unique($input); - print_r($result); -// Cela va afficher : -//Array -//( -// [0] => 3 -// [1] => 3 -// [2] => 4 -// [3] => 4 -//) -?&gt; +<![CDATA[ +<?php + $input = array (4,"4","3",4,3,"3"); + $result = array_unique ($input); + var_dump($result); +?> +]]> </programlisting> - </example> - </para> + <para> + Le rŽsultat du programme sera (PHP 4.0.6) : + <screen role="php"> +<![CDATA[ +array(2) { + [3]=> + int(4) + [4]=> + int(3) +} +]]> + </screen> + </para> + </example> + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-unshift.xml diff -u phpdoc-fr/reference/array/functions/array-unshift.xml:1.1 phpdoc-fr/reference/array/functions/array-unshift.xml:1.2 --- phpdoc-fr/reference/array/functions/array-unshift.xml:1.1 Sun Apr 14 20:22:02 2002 +++ phpdoc-fr/reference/array/functions/array-unshift.xml Tue Feb 4 12:46:06 2003 @@ -32,26 +32,35 @@ <example> <title>Exemples avec <function>array_unshift</function></title> <programlisting role="php"> -&lt;?php - $queue = array("p1", "p3"); - array_unshift($queue, "p4", "p5", "p6"); -?&gt; +<![CDATA[ +<?php + $queue = array ("orange", "banane"); + array_unshift ($queue, "pomme", "framboise"); + print_r($queue); +?> +]]> </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". + <para> + <varname>$queue</varname> vaut : + <screen role="php"> +<![CDATA[ +Array +( + [0] => pomme + [1] => framboise + [2] => orange + [3] => banane +) +]]> + </screen> + </para> + </example> </para> <para> Voir aussi <function>array_shift</function>, <function>array_push</function>, et <function>array_pop</function>. - <note> - <para> - <function>array_unshift</function> a &eacute;t&eacute; ajout&eacute;e en - PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-values.xml diff -u phpdoc-fr/reference/array/functions/array-values.xml:1.1 phpdoc-fr/reference/array/functions/array-values.xml:1.2 --- phpdoc-fr/reference/array/functions/array-values.xml:1.1 Sun Apr 14 20:22:02 2002 +++ phpdoc-fr/reference/array/functions/array-values.xml Tue Feb 4 12:46:06 2003 @@ -13,18 +13,32 @@ <methodparam><type>array</type><parameter>input</parameter></methodparam> </methodsynopsis> <para> - <function>array_values</function>retourne les valeurs du tableau - <parameter>input</parameter>. + <function>array_values</function> retourne les valeurs du tableau + <parameter>input</parameter> et indexe numŽriquement le tableau. </para> <para> <example> <title>Exemples avec <function>array_values</function></title> <programlisting role="php"> -&lt;?php - $array = array("taille" =&gt; "XL", "couleur" =&gt; "or"); - array_values($array); // // retourne array("XL", "or") -?&gt; +<![CDATA[ +<?php + $array = array ("taille" => "XL", "couleur" => "vert"); + print_r(array_values ($array)); +?> +]]> </programlisting> + <para> + Cet exemple affiche : + <screen role="php"> +<![CDATA[ +Array +( + [0] => XL + [1] => vert +) +]]> + </screen> + </para> </example> <note> <para> @@ -33,24 +47,29 @@ toujours PHP 3. <example> <title> - Impl&eacute;mentation de <function>array_values</function> pour les utilisateurs - PHP 3 + <function>array_values</function> pour les utilisateurs PHP 3 </title> <programlisting role="php"> -&lt;?php - function array_values($arr){ +<![CDATA[ +<?php +function array_values ($arr) { $t = array(); - while (list($k, $v) = each($arr)){ + while (list($k, $v) = each ($arr)) { $t[] = $v; } return $t; - } -?&gt; +} +?> +]]> </programlisting> </example> </para> </note> </para> + <para> + Voir aussi + <function>array_keys</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/array-walk.xml diff -u phpdoc-fr/reference/array/functions/array-walk.xml:1.1 phpdoc-fr/reference/array/functions/array-walk.xml:1.2 --- phpdoc-fr/reference/array/functions/array-walk.xml:1.1 Sun Apr 14 20:22:02 2002 +++ phpdoc-fr/reference/array/functions/array-walk.xml Tue Feb 4 12:46:06 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>array_walk</methodname> - <methodparam><type>array</type><parameter>arr</parameter></methodparam> - <methodparam><type>string</type><parameter>func</parameter></methodparam> - <methodparam><type>mixed</type><parameter>userdata</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>array_walk</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>userdata</parameter></methodparam> + </methodsynopsis> <simpara> <function>array_walk</function> ex&eacute;cute la fonction <parameter>func</parameter> avec chaque &eacute;l&eacute;ment du tableau <parameter>arr</parameter>. Les @@ -56,24 +56,46 @@ <example> <title>Exemple avec <function>array_walk</function></title> <programlisting role="php"> -&lt;?php - $fruits = array ("d"=&gt;"citron", "a"=&gt;"orange", "b"=&gt;"banane", "c"=&gt;"pomme"); - function test_alter (&amp;$item1, $key, $prefix) { +<![CDATA[ +<?php + $fruits = array ("d"=>"citron", "a"=>"orange", "b"=>"banane", "c"=>"pomme"); + + function test_alter (&$item1, $key, $prefix) { $item1 = "$prefix: $item1"; } + function test_print ($item2, $key) { - echo "$key. $item2&lt;br&gt;\n"; + 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'); -?&gt; +?> +]]> </programlisting> - </example> - </para> - <simpara> + <para> + L'affichage de ce script sera : + <screen role="php"> +<![CDATA[ +d. citron<br> +a. orange<br> +b. banane<br> +c. pomme<br> +d. fruit: citron<br> +a. fruit: orange<br> +b. fruit: banane<br> +c. fruit: pomme<br> +]]> + </screen> + </para> + </example> + </para> + <simpara> Voir aussi <function>each</function> et <function>list</function>. Index: phpdoc-fr/reference/array/functions/array.xml diff -u phpdoc-fr/reference/array/functions/array.xml:1.1 phpdoc-fr/reference/array/functions/array.xml:1.2 --- phpdoc-fr/reference/array/functions/array.xml:1.1 Sun Apr 14 20:22:02 2002 +++ phpdoc-fr/reference/array/functions/array.xml Tue Feb 4 12:46:06 2003 @@ -44,13 +44,14 @@ <example> <title>Exemple avec <function>array</function></title> <programlisting role="php"> -&lt;?php - $fruits = array ( - "fruits" =&gt; array ("a" =&gt; "orange", "b" =&gt; "banane", "c" =&gt; "pomme"), - "numbres" =&gt; array (1, 2, 3, 4, 5, 6), - "trous" =&gt; array ("premier", 5 =&gt; "deuxi&egrave;me", "troisi&egrave;me") - ); -?&gt; +<![CDATA[ +<?php +$fruits = array ( + "fruits" => array ("a"=>"orange", "b"=>"banane", "c"=>"pomme"), + "nombres" => array (1, 2, 3, 4, 5, 6), + "trous" => array ("premier", 5 => "second", "troisime") +); +]]> </programlisting> </example> </para> @@ -58,25 +59,29 @@ <example> <title>Index automatique d'un tableau avec <function>array</function></title> <programlisting role="php"> -&lt;?php - $array = array( 1, 1, 1, 1, 1, 8=&gt;1, 4=&gt;1, 19, 3=&gt;13); +<![CDATA[ +<?php + $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); print_r($array); -?&gt; +?> +]]> </programlisting> </example> qui affichera : <informalexample> <programlisting> +<![CDATA[ Array ( - [0] =&gt; 1 - [1] =&gt; 1 - [2] =&gt; 1 - [3] =&gt; 13 - [4] =&gt; 1 - [8] =&gt; 1 - [9] =&gt; 19 + [0] => 1 + [1] => 1 + [2] => 1 + [3] => 13 + [4] => 1 + [8] => 1 + [9] => 19 ) +]]> </programlisting> </informalexample> </para> @@ -91,27 +96,33 @@ <example> <title>Tableau d'index commen&ccedil;ant &agrave; 1</title> <programlisting role="php"> -&lt;?php - $firstquarter = array(1 =&gt; 'Janvier', 'F&eacute;vrier', 'Mars'); +<![CDATA[ +<?php + $firstquarter = array(1 => 'Janvier', 'F&eacute;vrier', 'Mars'); print_r($firstquarter); -?&gt; +?> +]]> </programlisting> </example> qui affichera : <informalexample> <screen> - Array - ( - [1] =&gt; 'Janvier' - [2] =&gt; 'F&eacute;vrier' - [3] =&gt; 'Mars' - ) +<![CDATA[ +Array +( + [1] => Janvier + [2] => F&eacute;vrier + [3] => Mars +) +]]> </screen> </informalexample> </para> <para> Voir aussi - <function>list</function>. + <function>array_pad</function>, + <function>list</function> et + <function>range</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/arsort.xml diff -u phpdoc-fr/reference/array/functions/arsort.xml:1.1 phpdoc-fr/reference/array/functions/arsort.xml:1.2 --- phpdoc-fr/reference/array/functions/arsort.xml:1.1 Sun Apr 14 20:22:03 2002 +++ phpdoc-fr/reference/array/functions/arsort.xml Tue Feb 4 12:46:06 2003 @@ -10,10 +10,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>arsort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>arsort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> <para> <function>arsort</function> trie un tableau de telle mani&egrave;re que la corr&eacute;lation entre les index et les valeurs soit @@ -22,25 +23,34 @@ <example> <title>Exemple avec <function>arsort</function></title> <programlisting role="php"> -&lt;?php - $fruits = array("d"=&gt;"papaye","a"=&gt;"orange","b"=&gt;"banane","c"=&gt;"ananas"); +<![CDATA[ +<?php + $fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas"); arsort ($fruits); - for (reset ($fruits); $key = key ($fruits); next ($fruits)) { + for (reset ($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; } -?&gt; +?> +]]> </programlisting> </example> Cet exemple va afficher: <computeroutput> - fruits[d] = papaye - fruits[a] = orange - fruits[b] = banane - fruits[c] = ananas +<![CDATA[ +fruits[d] = papaye +fruits[a] = orange +fruits[b] = banane +fruits[c] = ananas +]]> </computeroutput> Les fruits ont &eacute;t&eacute; tri&eacute;s en ordre alphab&eacute;tique inverse, et leurs index respectifs ont &eacute;t&eacute; conserv&eacute;s. </para> + <para> + Vous pouvez modifier le comportement de cette fonction en utilisant + le param&egrave;tre optionnel <parameter>sort_flags</parameter>. Pour plus + de d&eacute;tails, voyez le manuel pour la fonction <function>sort</function>. + </para> <para> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/asort.xml diff -u phpdoc-fr/reference/array/functions/asort.xml:1.1 phpdoc-fr/reference/array/functions/asort.xml:1.2 --- phpdoc-fr/reference/array/functions/asort.xml:1.1 Sun Apr 14 20:22:03 2002 +++ phpdoc-fr/reference/array/functions/asort.xml Tue Feb 4 12:46:06 2003 @@ -8,10 +8,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>asort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>asort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> <para> <function>asort</function> trie un tableau de telle mani&egrave;re que la corr&eacute;lation entre les index et les valeurs soit conserv&eacute;e. @@ -20,28 +21,37 @@ <example> <title>Exemple avec <function>asort</function></title> <programlisting role="php"> -&lt;?php - $fruits = array( "d"=&gt;"papaye", - "a"=&gt;"orange", - "b"=&gt;"banane", - "c"=&gt;"ananas"); +<![CDATA[ +<?php + $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"; } -?&gt; +?> +]]> </programlisting> </example> Cet exemple va afficher: <computeroutput> - fruits[c] = ananas - fruits[b] = banane - fruits[a] = orange - fruits[d] = papaye +<![CDATA[ +fruits[c] = ananas +fruits[b] = banane +fruits[a] = orange +fruits[d] = papaye +]]> </computeroutput> Les fruits ont &eacute;t&eacute; tri&eacute;s par ordre alphab&eacute;tique, et leurs index respectifs ont &eacute;t&eacute; conserv&eacute;s. </para> + <para> + Vous pouvez modifier le comportement de cette fonction en utilisant + le param&egrave;tre optionnel <parameter>sort_flags</parameter>. Pour plus + de d&eacute;tails, voyez le manuel pour la fonction <function>sort</function>. + </para> <para> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/compact.xml diff -u phpdoc-fr/reference/array/functions/compact.xml:1.1 phpdoc-fr/reference/array/functions/compact.xml:1.2 --- phpdoc-fr/reference/array/functions/compact.xml:1.1 Sun Apr 14 20:22:03 2002 +++ phpdoc-fr/reference/array/functions/compact.xml Tue Feb 4 12:46:06 2003 @@ -10,11 +10,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>compact</methodname> - <methodparam><type>string|array</type><parameter>varname</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>compact</methodname> + <methodparam><type>mixed</type><parameter>varname</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> <para> <function>compact</function> accepte diff&eacute;rents param&egrave;tres. Les param&egrave;tres peuvent &ecirc;tre des variables contenant des cha&icirc;nes, @@ -33,18 +33,29 @@ <example> <title>Exemple avec <function>compact</function></title> <programlisting role="php"> -&lt;?php - $ville = "San Francisco"; - $etat = "CA"; - $evenement = "SIGGRAPH"; - $location_vars = array("ville", "etat"); +<![CDATA[ +<?php + $ville = "Montr&eacute;al"; + $province = "Qu&eacute;bec"; + $evenement = "conf&eacute;rence PHP Qu&eacute;bec"; + $location_vars = array("ville", "province"); $result = compact("evenement", $location_vars); -?&gt; +?> +]]> </programlisting> - <para> - Apr&egrave;s cette op&eacute;ration, $result sera le tableau suivant : - array(("evenement" =&gt; "SIGGRAPH", "ville" =&gt; "San Francisco", "etat" =&gt; "CA"). - </para> + <para> + Apr&egrave;s ce programme, <varname>$result</varname> contiendra : + <screen role="php"> +<![CDATA[ +Array +( + [evenement] => conf&eacute;rence PHP Qu&eacute;bec + [ville] => Montr&eacute;al + [province] => Qu&eacute;bec +) +]]> + </screen> + </para> </example> </para> <para> Index: phpdoc-fr/reference/array/functions/count.xml diff -u phpdoc-fr/reference/array/functions/count.xml:1.1 phpdoc-fr/reference/array/functions/count.xml:1.2 --- phpdoc-fr/reference/array/functions/count.xml:1.1 Sun Apr 14 20:22:03 2002 +++ phpdoc-fr/reference/array/functions/count.xml Tue Feb 4 12:46:06 2003 @@ -36,16 +36,29 @@ <example> <title>Exemple avec <function>count</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $a[0] = 1; $a[1] = 3; $a[2] = 5; $result = count ($a); - //$result == 3 -?&gt; +// $result == 3 + + $b[0] = 7; + $b[5] = 9; + $b[10] = 11; + $result = count ($b); +// $result == 3; +?> +]]> </programlisting> </example> </para> + <note> + <para> + <function>sizeof</function> est un &alias; de <function>count</function>. + </para> + </note> <para> Voir aussi <function>sizeof</function>, Index: phpdoc-fr/reference/array/functions/each.xml diff -u phpdoc-fr/reference/array/functions/each.xml:1.2 phpdoc-fr/reference/array/functions/each.xml:1.3 --- phpdoc-fr/reference/array/functions/each.xml:1.2 Wed Oct 9 18:34:49 2002 +++ phpdoc-fr/reference/array/functions/each.xml Tue Feb 4 12:46:06 2003 @@ -34,60 +34,71 @@ <programlisting role="php"> <![CDATA[ <?php - $foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese"); + $foo = array("ghislain", "damien", "didou", "guillaume", "jim", "christophe"); $bar = each($foo); + print_r($bar); ?> ]]> </programlisting> <para> - <literal>$bar</literal> contient maintenant les paires suivantes: - <itemizedlist spacing="compact"> - <listitem><simpara>0 =&gt; 0</simpara></listitem> - <listitem><simpara>1 =&gt; 'bob'</simpara></listitem> - <listitem><simpara>key =&gt; 0</simpara></listitem> - <listitem><simpara>value =&gt; 'bob'</simpara></listitem> - </itemizedlist> + <literal>$bar</literal> contient maintenant les paires suivantes : + <screen> +<![CDATA[ +Array +( + [1] => ghislain + [value] => ghislain + [0] => 0 + [key] => 0 +) +]]> + </screen> <programlisting role="php"> <![CDATA[ <?php - $foo = array("Robert" => "Bob", "Seppo" => "Sepi"); + $foo = array( "Mehdi" => "Didou","Damien" => "Dams"); $bar = each($foo); + print_r($bar); ?> ]]> </programlisting> </para> <para> - <literal>$bar</literal> contient maintenant les paires suivantes: - <itemizedlist spacing="compact"> - <listitem><simpara>0 =&gt; 'Robert'</simpara></listitem> - <listitem><simpara>1 =&gt; 'Bob'</simpara></listitem> - <listitem><simpara>key =&gt; 'Robert'</simpara></listitem> - <listitem><simpara>value =&gt; 'Bob'</simpara></listitem> - </itemizedlist> + <literal>$bar</literal> contient maintenant les paires suivantes : + <screen> +<![CDATA[ +Array +( + [1] => Didou + [value] => Didou + [0] => Mehdi + [key] => Mehdi +) +]]> + </screen> </para> </example> </para> - <para> - <function>each</function> est utilis&eacute; conjointement avec - <function>list</function> pour &eacute;tudier tous les &eacute;l&eacute;ments - d'un tableau; par exemple, $HTTP_POST_VARS: - <example> - <title> - Affichage de $HTTP_POST_VARS avec <function>each</function> - </title> - <programlisting role="php"> - <![CDATA[ -<?php - echo "Valeurs transmises par la m&eacute;thode POST<BR>"; - reset($HTTP_POST_VARS); - while(list ($key, $val) = each ($HTTP_POST_VARS)) { - echo "$key => $val<BR>"; - } -?> + <para> + <function>each</function> est typiquement utilisŽ en conjonction + avec <function>list</function> pour passer en revue un tableau. Par exemple, + avec <varname>$_POST</varname> : + <example> + <title> + Passer en revue <varname>$_POST</varname> avec + <function>each</function> + </title> + <programlisting role="php"> +<![CDATA[ +echo "Valeurs transmises via la mŽthode POST :<br />\n"; +reset ($_POST); +while (list ($key, $val) = each ($_POST)) { + echo "$key => $val<br />\n"; +} ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> <para> Apr&egrave;s chaque <function>each</function>, le pointeur de tableau est d&eacute;plac&eacute; au prochain &eacute;l&eacute;ment, ou sur le dernier @@ -99,8 +110,9 @@ <function>list</function>, <function>current</function>, <function>reset</function>, - <function>next</function> et - <function>prev</function>. + <function>next</function>, + <function>prev</function> et + <link linkend="control-structures.foreach">foreach</link>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/end.xml diff -u phpdoc-fr/reference/array/functions/end.xml:1.1 phpdoc-fr/reference/array/functions/end.xml:1.2 --- phpdoc-fr/reference/array/functions/end.xml:1.1 Sun Apr 14 20:22:04 2002 +++ phpdoc-fr/reference/array/functions/end.xml Tue Feb 4 12:46:06 2003 @@ -10,14 +10,30 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <methodname>end</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>end</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> <para> <function>end</function> d&eacute;place le pointeur interne du tableau <parameter>array</parameter> jusqu'au dernier &eacute;l&eacute;ment. </para> + <para> + <example> + <title>Exemple avec <function>end</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + + $fruits = array('pomme','banane','myrtille'); + + print end($fruits); // myrtille + +?> +]]> + </programlisting> + </example> + </para> <para> Voir aussi <function>current</function>, Index: phpdoc-fr/reference/array/functions/extract.xml diff -u phpdoc-fr/reference/array/functions/extract.xml:1.1 phpdoc-fr/reference/array/functions/extract.xml:1.2 --- phpdoc-fr/reference/array/functions/extract.xml:1.1 Sun Apr 14 20:22:04 2002 +++ phpdoc-fr/reference/array/functions/extract.xml Tue Feb 4 12:46:06 2003 @@ -31,6 +31,17 @@ variables extraites. </para> </note> + <note> + <para> + <constant>EXTR_IF_EXISTS</constant> et <constant>EXTR_PREFIX_IF_EXISTS</constant> + ont ŽtŽ introduites en &php; version 4.2.0. + </para> + </note> + <note> + <para> + <constant>EXTR_REFS</constant> a ŽtŽ introduite en &php; 4.3.0. + </para> + </note> <para> <function>extract</function> v&eacute;rifie l'existence de la variable avant de la cr&eacute;er. Le traitement des collisions est @@ -38,7 +49,7 @@ Ce param&egrave;tre peut prendre une des valeurs suivantes : <variablelist> <varlistentry> - <term>EXTR_OVERWRITE</term> + <term><constant>EXTR_OVERWRITE</constant></term> <listitem> <simpara> Lors d'une collision, r&eacute;&eacute;crire la variable existante. @@ -46,7 +57,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_SKIP</term> + <term><constant>EXTR_SKIP</constant></term> <listitem> <simpara> Lors d'une collision, ne pas r&eacute;&eacute;crire la variable existante. @@ -54,7 +65,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_SAME</term> + <term><constant>EXTR_PREFIX_SAME</constant></term> <listitem> <simpara> Lors d'une collision, ajouter le pr&eacute;fixe <parameter>prefix</parameter>, @@ -63,7 +74,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_ALL</term> + <term><constant>EXTR_PREFIX_ALL</constant></term> <listitem> <simpara> Ajouter le pr&eacute;fixe <parameter>prefix</parameter>, et cr&eacute;er @@ -72,7 +83,7 @@ </listitem> </varlistentry> <varlistentry> - <term>EXTR_PREFIX_INVALID</term> + <term><constant>EXTR_PREFIX_INVALID</constant></term> <listitem> <simpara> Pr&eacute;fixer uniquement les variables aux noms invalides ou num&eacute;riques @@ -81,17 +92,55 @@ </simpara> </listitem> </varlistentry> + <varlistentry> + <term><constant>EXTR_IF_EXISTS</constant></term> + <listitem> + <simpara> + ƒcrase la variable uniquement si elle existe dŽjˆ dans la + table des symboles, et sinon, ne rien faire. Ceci est + pratique pour dŽfinir une liste de variables valides, puis + d'extraire du tableau les valeurs que vous avez dŽjˆ dŽfinies + gr‰ce ˆ <varname>$_REQUEST</varname>, par exemple. + Cette option a ŽtŽ ajoutŽe en &php; 4.2.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>EXTR_PREFIX_IF_EXISTS</constant></term> + <listitem> + <simpara> + Ne crŽe que des variables prŽfixŽes, si la version non prŽfixŽe + de la mme variable existe dans la table des symboles courante. + Cette option a ŽtŽ ajoutŽe en &php; 4.2.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>EXTR_REFS</constant></term> + <listitem> + <simpara> + Extrait les variables sous forme de rŽfŽrences. Cela signifie que + les valeurs des variables importŽes font toujours rŽfŽrence aux + valeurs des variables d'orgine dans le paramtre + <parameter>var_array</parameter>. Vous pouvez utiliser cette + option seule, ou bien la combiner avec d'autres option avec + l'opŽrateur OR, dans le paramtre <parameter>extract_type</parameter>. + Cette option a ŽtŽ ajoutŽe en &php; 4.3.0. + </simpara> + </listitem> + </varlistentry> </variablelist> </para> <para> Si <parameter>extract_type</parameter> est omis, <function>extract</function> - utilise EXTR_OVERWRITE par d&eacute;faut. + utilise <constant>EXTR_OVERWRITE</constant> par d&eacute;faut. </para> <para> Notez que <parameter>prefix</parameter> n'est n&eacute;cessaire que pour les valeurs de <parameter>extract_type</parameter> suivantes : - EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le r&eacute;sultat - pr&eacute;fix&eacute; n'est pas un nom de variable valide, + <constant>EXTR_PREFIX_SAME</constant>, <constant>EXTR_PREFIX_ALL</constant>, + <constant>EXTR_PREFIX_INVALID</constant> ou <constant>EXTR_PREFIX_IF_EXISTS</constant>. + Le r&eacute;sultat pr&eacute;fix&eacute; n'est pas un nom de variable valide, il ne sera pas import&eacute; dans la table des symboles. </para> <para> @@ -107,34 +156,47 @@ <example> <title>Exemple avec <function>extract</function></title> <programlisting role="php"> -&lt;?php -/* Supposons que $var_array est un tableau retourn&eacute; par - <function>wddx_deserialize</function> */ +<![CDATA[ +<?php +/* Supposons que $var_array est un tableau retourn&eacute; + par wddx_deserialize() */ $taille = "grand"; - $var_array = array("couleur" =&gt; "bleu", - "taille" =&gt; "moyen", - "forme" =&gt; "sphere"); + $var_array = array("couleur" => "bleu", + "taille" => "moyen", + "forme" => "sphere"); extract($var_array, EXTR_PREFIX_SAME, "wddx"); print "$couleur, $taille, $forme, $wddx_taille\n"; -?&gt; +?> +]]> </programlisting> </example> </para> - <para> - L'exemple ci-dessus va afficher - <computeroutput> - bleu, large, sphere, moyen - </computeroutput> - </para> + <para> + The above example will produce: + <programlisting> +<![CDATA[ +bleu, grand, sphere, moyen +]]> + </programlisting> + </para> <para> La variable $taille n'a pas &eacute;t&eacute; r&eacute;&eacute;crite, car on - avait sp&eacute;cifi&eacute; le param&egrave;tre EXTR_PREFIX_SAME, qui a permis - la cr&eacute;ation $wddx_size. Si EXTR_SKIP avait &eacute;t&eacute; + avait sp&eacute;cifi&eacute; le param&egrave;tre <constant>EXTR_PREFIX_SAME</constant>, qui a permis + la cr&eacute;ation $wddx_size. Si <constant>EXTR_SKIP</constant> avait &eacute;t&eacute; utilis&eacute;, alors $wddx_size n'aurait pas &eacute;t&eacute; - cr&eacute;&eacute;. Avec EXTR_OVERWRITE, $taille aurait pris la valeur "moyen", - et avec EXTR_PREFIX_ALL, les variables cr&eacute;&eacute;es seraient + cr&eacute;&eacute;. Avec <constant>EXTR_OVERWRITE</constant>, $taille aurait pris la valeur "moyen", + et avec <constant>EXTR_PREFIX_ALL</constant>, les variables cr&eacute;&eacute;es seraient $wddx_couleur, $wddx_taille, et $wddx_forme. </para> + <para> + Vous devez utiliser un tableau associatif. Un tableau indexŽ numŽriquement + ne produira aucun rŽsultat, ˆ moins que vous n'utilisiez l'option + <constant>EXTR_PREFIX_ALL</constant> ou <constant>EXTR_PREFIX_INVALID</constant>. + </para> + <para> + Voir aussi + <function>compact</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/in-array.xml diff -u phpdoc-fr/reference/array/functions/in-array.xml:1.2 phpdoc-fr/reference/array/functions/in-array.xml:1.3 --- phpdoc-fr/reference/array/functions/in-array.xml:1.2 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/reference/array/functions/in-array.xml Tue Feb 4 12:46:06 2003 @@ -11,10 +11,10 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>in_array</methodname> + <type>bool</type><methodname>in_array</methodname> <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> <methodparam><type>array</type><parameter>haystack</parameter></methodparam> - <methodparam choice="opt"><type>boolean</type><parameter>strict</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam> </methodsynopsis> <para> <function>in_array</function> recherche <parameter>needle</parameter> dans @@ -27,51 +27,98 @@ v&eacute;rifiera aussi que le types du param&egrave;tre <parameter>needle</parameter> correspond &agrave; la valeur trouv&eacute;e dans <parameter>haystack</parameter>. </para> + <note> + <para> + Si <parameter>needle</parameter> est une cha”ne, la comparaison + est fa”te en tenant compte de la casse. + </para> + </note> + <note> + <para> + Dans les versions antŽrieure ˆ 4.2.0, <parameter>needle</parameter> ne pouvait + pas tre un tableau. + </para> + </note> <para> <example> <title>Exemple avec <function>in_array</function></title> <programlisting role="php"> -&lt;?php - $os = array("Mac", "NT", "Irix", "Linux"); - if (in_array("Irix", $os)) - print "Irix trouve"; -?&gt; +<![CDATA[ +<?php + $os = array ("Mac", "NT", "Irix", "Linux"); + if (in_array ("Linux", $os)) { + print "TrouvŽ Linux"; + } + if (in_array ("mac", $os)) { + print "TrouvŽ mac"; + } +?> +]]> </programlisting> + <para> + La seconde condition Žchoue, car <function>in_array</function> + est sensible ˆ la casse. Le script retourne : + <screen role="php"> +<![CDATA[ +TrouvŽ Linux +]]> + </screen> + </para> </example> </para> - <para> - <example> - <title> - <function>in_array</function> avec le param&egrave;tre <parameter>strict</parameter> - </title> - <programlisting role="php"> -&lt;?php - $a = array('1.10', 12.4, 1.13); - if (in_array('12.4', $a, &true;)) - echo &quot;'12.4' trouv&eacute; avec une recherche stricte\n&quot;; - if (in_array(1.13, $a, &true;)) - echo &quot;1.13 trouv&eacute; avec une recherche stricte\n&quot;; -?&gt; - </programlisting> - </example> - </para> - <para> - L'affichage sera : - </para> - <informalexample> - <screen> - 1.13 trouv&eacute; avec une recherche stricte - </screen> - </informalexample> - <note> <para> - <function>in_array</function> a &eacute;t&eacute; ajout&eacute;e en PHP 4.0. + <example> + <title>Exemple avec <function>in_array</function> et le mode sctrict</title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = array('1.10', 12.4, 1.13); + +if (in_array('12.4', $a, TRUE)) + echo "'12.4' a ŽtŽ trouvŽ avec recherche stricte\n"; +if (in_array(1.13, $a, TRUE)) + echo "1.13 a ŽtŽ trouvŽ avec recherche stricte\n"; +?> +]]> + </programlisting> + <para> + Ce script va afficher : + <screen role="php"> +<![CDATA[ +1.13 a ŽtŽ trouvŽ avec recherche stricte +]]> + </screen> + </para> + </example> + </para> + <para> + <example> + <title>Exemple avec <function>in_array</function> et deux tableaux en paramtres</title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = array(array('p', 'h'), array('p', 'r'), 'o'); + +if (in_array(array ('p', 'h'), $a)) + echo "'ph' a ŽtŽ trouvŽ\n"; +if (in_array(array ('f', 'i'), $a)) + echo "'fi' a ŽtŽ trouvŽ\n"; +if (in_array('o', $a)) + echo "'o' a ŽtŽ trouvŽ\n"; +?> + +// This will output: + +'ph' a ŽtŽ trouvŽ +'o' a ŽtŽ trouvŽ +]]> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>array_search</function>. </para> - </note> - <para> - Voir aussi - <function>array_search</function>. - </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/krsort.xml diff -u phpdoc-fr/reference/array/functions/krsort.xml:1.1 phpdoc-fr/reference/array/functions/krsort.xml:1.2 --- phpdoc-fr/reference/array/functions/krsort.xml:1.1 Sun Apr 14 20:22:05 2002 +++ phpdoc-fr/reference/array/functions/krsort.xml Tue Feb 4 12:46:06 2003 @@ -10,10 +10,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>krsort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>krsort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> <para> <function>krsort</function> trie un tableau en ordre inverse et suivant les cl&eacute;s, en maintenant la correspondance entre les cl&eacute;s et les @@ -21,23 +22,32 @@ <example> <title>Exemple avec <function>krsort</function></title> <programlisting role="php"> -&lt;?php - $fruits = array("d"=&gt;"papaye","a"=&gt;"orange","b"=&gt;"banane","c"=&gt;"ananas"); +<![CDATA[ +<?php + $fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas"); ksort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; } -?&gt; +?> +]]> </programlisting> </example> Cet exemple va afficher : <computeroutput> - fruits[d] = citron - fruits[c] = ananas - fruits[b] = banane - fruits[a] = orange +<![CDATA[ +fruits[a] = orange +fruits[b] = banane +fruits[c] = ananas +fruits[d] = papaye +]]> </computeroutput> </para> + <para> + Vous pouvez modifier le comportement de cette fonction en utilisant + le param&egrave;tre optionnel <parameter>sort_flags</parameter>. Pour plus + de d&eacute;tails, voyez le manuel pour la fonction <function>sort</function>. + </para> <simpara> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/ksort.xml diff -u phpdoc-fr/reference/array/functions/ksort.xml:1.1 phpdoc-fr/reference/array/functions/ksort.xml:1.2 --- phpdoc-fr/reference/array/functions/ksort.xml:1.1 Sun Apr 14 20:22:05 2002 +++ phpdoc-fr/reference/array/functions/ksort.xml Tue Feb 4 12:46:06 2003 @@ -8,10 +8,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ksort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>ksort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> <para> <function>ksort</function> trie un tableau suivant les cl&eacute;s, en maintenant la correspondance entre les @@ -20,29 +21,33 @@ <example> <title>Exemple avec <function>ksort</function></title> <programlisting role="php"> -&lt;?php - $fruits = array("d"=&gt;"papaye","a"=&gt;"orange","b"=&gt;"banane","c"=&gt;"ananas"); +<![CDATA[ +<?php + $fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas"); ksort($fruits); reset($fruits); while (list ($key, $val) = each ($fruits)) { - echo "$key =&gt; $val\n"; + echo "$key => $val\n"; } -?&gt; +?> +]]> </programlisting> </example> Cet exemple va afficher : <computeroutput> - fruits[a] = orange - fruits[b] = banane - fruits[c] = ananas - fruits[d] = citron +<![CDATA[ +a => orange +b => banane +c => ananas +d => papaye +]]> </computeroutput> </para> - <para> - Vous pouvez modifier le comportement du tri avec les - options <parameter>sort_flags</parameter>. Pour plus de - d&eacute;tails, voyez <function>sort</function>. - </para> + <para> + Vous pouvez modifier le comportement de cette fonction en utilisant + le param&egrave;tre optionnel <parameter>sort_flags</parameter>. Pour plus + de d&eacute;tails, voyez le manuel pour la fonction <function>sort</function>. + </para> <simpara> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/list.xml diff -u phpdoc-fr/reference/array/functions/list.xml:1.1 phpdoc-fr/reference/array/functions/list.xml:1.2 --- phpdoc-fr/reference/array/functions/list.xml:1.1 Sun Apr 14 20:22:05 2002 +++ phpdoc-fr/reference/array/functions/list.xml Tue Feb 4 12:46:06 2003 @@ -10,40 +10,117 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>list</methodname> - <void/> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>list</methodname> + <methodparam rep="repeat"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> <para> Tout comme <function>array</function>, <function>list</function> n'est pas une - v&eacute;ritable fonction, mais une construction syntaxique, + v&eacute;ritable fonction, mais un &eacute;l&eacute;ment de langage, qui permet d'assigner une s&eacute;rie de variables en une seule ligne. - <example> - <title>Exemple avec <function>list</function></title> - <programlisting role="php"> -&lt;?php -&lt;table&gt; - &lt;tr&gt; - &lt;th&gt;Nom de l'employ&eacute;&lt;/th&gt; - &lt;th&gt;Salaire&lt;/th&gt; - &lt;/tr&gt; -&lt;?php - $result = mysql_query($conn, "SELECT id, name, salary FROM employees"); - while (list($id, $name, $salary) = mysql_fetch_row ($result)) { - print (" &lt;tr&gt;\n". - " &lt;td&gt;&lt;a href=\"info.php3?id=$id\"&gt;$name&lt;/a&gt;&lt;/td&gt;\n". - " &lt;td&gt;$salaire&lt;/td&gt;\n". - " &lt;/tr&gt;\n"); - } -?&gt; -&lt;/table&gt; -?&gt; - </programlisting> - </example> - </para> + </para> + <note> + <para> + <function>list</function> fonctionne uniquement avec des tableaux + &agrave; indexation num&eacute;rique, et suppose que l'indexaction commence &agrave; 0. + </para> + </note> + <para> + <example> + <title>Exemple avec <function>list</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$info = array('caf&eacute;', 'noir', 'cafeine'); + +// Liste de toutes les variables +list($drink, $color, $power) = $info; +print "$drink est $color et la $power le rend particulier.\n"; + +// Liste de certaines variables +list($drink, , $power) = $info; +print "$drink contient de la $power.\n"; + +// Ou bien, n'utilisons que le troisi&egrave;me +list( , , $power) = $info; +print "J'ai besoin de $power!\n"; + +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Exemple avec <function>list</function> et MySQL</title> + <programlisting role="php"> +<![CDATA[ +<table> + <tr> + <th>Nom de l'employ&eacute;</th> + <th>Salaire</th> + </tr> + +<?php + +$resultat = mysql_query ("SELECT id, nom, salaire FROM employes",$conn); +while (list ($id, $nom, $salaire) = mysql_fetch_row ($resultat)) { + print (" <tr>\n". + " <td><a href=\"info.php?id=$id\">$nom</a></td>\n". + " <td>$salaire</td>\n". + " </tr>\n"); +} + +?> +</table> +]]> + </programlisting> + </example> + </para> + <warning> + <para> + <function>list</function> assigne les valeurs en commencant par la valeur + la plus &agrave; droite. Si vous utiliser ces variables, ce ne sera pas un probl&egrave;me. + Mais si vous utilisez des tableaux, vous serez surpris de voir que + <function>list</function> les affecte de droite &agrave; gauche. + </para> + </warning> + <para> + <example> + <title>Exemple avec <function>list</function> en tenan compte de l'ordre</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$info = array('caf&eacute;', 'noir', 'cafeine'); + +list($a[0], $a[1], $a[2]) = $info; + +var_dump($a); + +?> +]]> + </programlisting> + </example> + Cet exemple donne le r&eacute;sultat suivant (notez l'ordre d'affichage des + &eacute;l&eacute;ments, en comparaison avec l'ordre dans lequel ils ont &eacute;t&eacute; &eacute;crits dans + la syntaxe de <function>list</function>) : + <screen> +array(3) { + [2]=> + string(8) "cafeine" + [1]=> + string(5) "noir" + [0]=> + string(6) "caf&eacute;" +} + </screen> + </para> <para> Voir aussi + <function>extract</function>, <function>each</function> et <function>array</function>. </para> Index: phpdoc-fr/reference/array/functions/natcasesort.xml diff -u phpdoc-fr/reference/array/functions/natcasesort.xml:1.1 phpdoc-fr/reference/array/functions/natcasesort.xml:1.2 --- phpdoc-fr/reference/array/functions/natcasesort.xml:1.1 Sun Apr 14 20:22:05 2002 +++ phpdoc-fr/reference/array/functions/natcasesort.xml Tue Feb 4 12:46:06 2003 @@ -31,19 +31,9 @@ </para> <para> Voir aussi - <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>. + <function>natcasesort</function>, + <function>strnatcmp</function> et + <function>strnatcasecmp</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/natsort.xml diff -u phpdoc-fr/reference/array/functions/natsort.xml:1.1 phpdoc-fr/reference/array/functions/natsort.xml:1.2 --- phpdoc-fr/reference/array/functions/natsort.xml:1.1 Sun Apr 14 20:22:05 2002 +++ phpdoc-fr/reference/array/functions/natsort.xml Tue Feb 4 12:46:06 2003 @@ -23,50 +23,60 @@ cha&icirc;nes (comme lorsqu'on utilise <function>sort</function>) est illustr&eacute; ci-dessous : </para> - <para> - <example> - <title>Exemple avec <function>natsort</function></title> - <programlisting role="php"> -&lt;?php - $array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png"); - sort($array1); - echo "Tri Standard\n"; - print_r($array1); - natsort($array2); - echo "\nTri par Ordre Naturel\n"; - print_r($array2); -?&gt; - </programlisting> - </example> - </para> - <para> - L'exemple ci-dessous g&eacute;n&egrave;re l'affichage suivant : - </para> - <para> - <informalexample> - <programlisting> -Tri Standard + <para> + <example> + <title>Exemple avec <function>natsort</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); + +sort($array1); +echo "Tri standard\n"; +print_r($array1); + +natsort($array2); +echo "Tri en ordre naturel\n"; +print_r($array2); +?> +]]> + </programlisting> + </example> + </para> + <para> + Le code ci-dessus va afficher : + </para> + <para> + <screen> +<![CDATA[ +Tri standard Array ( - [0] =&gt; img1.png - [1] =&gt; img10.png - [2] =&gt; img12.png - [3] =&gt; img2.png + [0] => img1.png + [1] => img10.png + [2] => img12.png + [3] => img2.png ) -Tri par Ordre Naturel +Tri en ordre naturel Array ( - [3] =&gt; img1.png - [2] =&gt; img2.png - [1] =&gt; img10.png - [0] =&gt; img12.png + [3] => img1.png + [2] => img2.png + [1] => img10.png + [0] => img12.png ) -?&gt; - </programlisting> - </informalexample> - Pour plus de d&eacute;tails, rendez-vous sur le site de Martin Pool +]]> + </screen> + Pour plus de d&eacute;tails, rendez-vous sur le site de : + Martin Pool's <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>. - </para> + </para> + <note> + <para> + Si vous souhaitez conserver la relation clŽ/valeur, + utilisez plut™t <literal>usort($arr, 'strnatcmp')</literal>. + </para> + </note> <para> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/range.xml diff -u phpdoc-fr/reference/array/functions/range.xml:1.1 phpdoc-fr/reference/array/functions/range.xml:1.2 --- phpdoc-fr/reference/array/functions/range.xml:1.1 Sun Apr 14 20:22:06 2002 +++ phpdoc-fr/reference/array/functions/range.xml Tue Feb 4 12:46:06 2003 @@ -9,20 +9,74 @@ </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Description</title> <methodsynopsis> <type>array</type><methodname>range</methodname> <methodparam><type>int</type><parameter>low</parameter></methodparam> <methodparam><type>int</type><parameter>high</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>step</parameter></methodparam> </methodsynopsis> <para> <function>range</function> retourne un tableau contenant tous les entiers depuis <parameter>low</parameter> jusqu'&agrave; <parameter>high</parameter>, - inclus. - </para> - <para> - Voir aussi <function>shuffle</function> (pour un exemple d'utilisation). + inclus. Si <parameter>low</parameter> est sup&eacute;rieur &agrave; + <parameter>high</parameter>, la s&eacute;quence sera en ordre d&eacute;croissant. </para> + <note> + <title>Nouveau param&egrave;tre</title> + <simpara> + Le param&egrave;tre optionnel <parameter>step</parameter> a &eacute;t&eacute; + ajout&eacute; en &php; 5.0. + </simpara> + </note> + <para> + Si une valeur est donn&eacute;e au pram&egrave;tre <parameter>step</parameter>, il sera utilis&eacute; + comme valeur incr&eacute;mentale entre les &eacute;l&eacute;ments de la s&eacute;quence. + <parameter>step</parameter> doit &ecirc;tre exprim&eacute; comme un nombre entier positif. + Si il n'est pas sp&eacute;cifi&eacute;, <parameter>step</parameter> vaut par d&eacute;faut 1. + </para> + <para> + <example> + <title>Exemple avec <function>range</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// array(0,1,2,3,4,5,6,7,8,9) +foreach(range(0, 9) as $number) { + echo $number; +} + +// La param&egrave;tre de pas (step) a &eacute;t&eacute; introduit en version 4.4.0 +// array(0,10,20,30,40,50,60,70,80,90,100) +foreach(range(0, 100, 10) as $number) { + echo $number; +} + +// L'utilisation des caract&egrave;res a &eacute;t&eacute; introduit en version 4.1.0 +// array('a','b','c','d','e','f','g','h','i'); +foreach(range('a', 'i') as $letter) { + echo $letter; +} +// array('c','b','a'); +foreach(range('c', 'a') as $letter) { + echo $letter; +} +?> +]]> + </programlisting> + </example> + </para> + <note> + <para> + Avant la version &php; 4.1.0, la fonction <function>range</function> + ne g&eacute;n&eacute;rait que des s&eacute;quences d'entiers. Le support des + s&eacute;quences de caract&egrave;res a &eacute;t&eacute; ajout&eacute; en &php; 4.1.0. + </para> + </note> + <para> + Voir aussi <function>shuffle</function> et + <link linkend="control-structures.foreach">foreach</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/rsort.xml diff -u phpdoc-fr/reference/array/functions/rsort.xml:1.1 phpdoc-fr/reference/array/functions/rsort.xml:1.2 --- phpdoc-fr/reference/array/functions/rsort.xml:1.1 Sun Apr 14 20:22:07 2002 +++ phpdoc-fr/reference/array/functions/rsort.xml Tue Feb 4 12:46:06 2003 @@ -8,35 +8,45 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>rsort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>rsort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> <para> <function>rsort</function> effectue un tri en ordre d&eacute;croissant (du plus grand au plus petit). <example> <title>Exemple avec <function>rsort</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $fruits = array("papaye","orange","banane","ananas"); rsort($fruits); for (reset($fruits); list($key,$value) = each($fruits); ) { echo "fruits[$key] = ", $value, "\n"; } -?&gt; +?> +]]> </programlisting> </example> Cet exemple va afficher: <computeroutput> - fruits[0] = papaye - fruits[1] = orange - fruits[2] = banane - fruits[3] = ananas +<![CDATA[ +fruits[0] = papaye +fruits[1] = orange +fruits[2] = banane +fruits[3] = ananas +]]> </computeroutput> Les fruits ont &eacute;t&eacute; class&eacute;s dans l'ordre alphab&eacute;tique inverse. </para> + <para> + Vous pouvez modifier le comportement de cette fonction en utilisant + le param&egrave;tre optionnel <parameter>sort_flags</parameter>. Pour plus + de d&eacute;tails, voyez le manuel pour la fonction <function>sort</function>. + </para> <para> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/shuffle.xml diff -u phpdoc-fr/reference/array/functions/shuffle.xml:1.1 phpdoc-fr/reference/array/functions/shuffle.xml:1.2 --- phpdoc-fr/reference/array/functions/shuffle.xml:1.1 Sun Apr 14 20:22:07 2002 +++ phpdoc-fr/reference/array/functions/shuffle.xml Tue Feb 4 12:46:06 2003 @@ -14,18 +14,21 @@ </methodsynopsis> <para> <function>shuffle</function> m&eacute;lange les &eacute;l&eacute;ments - d'un tableau. + d'un tableau. Vous devez utiliser <function>srand</function> pour initialiser + cette fonction. <example> <title>Exemple avec <function>shuffle</function></title> <programlisting role="php"> -&lt;?php - $numbers = range (1,20); - srand (time()); - shuffle ($numbers); - while (list(, $number) = each ($numbers)) { +<![CDATA[ +<?php +$numbers = range (1,20); +srand ((float)microtime()*1000000); +shuffle ($numbers); +while (list (, $number) = each ($numbers)) { echo "$number "; } -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/array/functions/sizeof.xml diff -u phpdoc-fr/reference/array/functions/sizeof.xml:1.1 phpdoc-fr/reference/array/functions/sizeof.xml:1.2 --- phpdoc-fr/reference/array/functions/sizeof.xml:1.1 Sun Apr 14 20:22:07 2002 +++ phpdoc-fr/reference/array/functions/sizeof.xml Tue Feb 4 12:46:06 2003 @@ -8,13 +8,13 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>sizeof</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> - <para> - <function>sizeof</function> retourne le nombre d'&eacute;l&eacute;ment d'un tableau. - </para> + <methodsynopsis> + <type>int</type><methodname>sizeof</methodname> + <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + </methodsynopsis> + <para> + <function>sizeof</function> est un &alias; de <function>count</function>. + </para> <para> Voir aussi <function>count</function>. Index: phpdoc-fr/reference/array/functions/sort.xml diff -u phpdoc-fr/reference/array/functions/sort.xml:1.1 phpdoc-fr/reference/array/functions/sort.xml:1.2 --- phpdoc-fr/reference/array/functions/sort.xml:1.1 Sun Apr 14 20:22:08 2002 +++ phpdoc-fr/reference/array/functions/sort.xml Tue Feb 4 12:46:06 2003 @@ -4,38 +4,68 @@ <refentry id="function.sort"> <refnamediv> <refname>sort</refname> - <refpurpose>Trie le tableau </refpurpose> + <refpurpose>Trie un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>sort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>sort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> <para> <function>sort</function> trie le tableau <parameter>array</parameter>. Les &eacute;l&eacute;ments seront tri&eacute;s du plus petit au plus grand. <example> <title>Exemple avec <function>sort</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $fruits = array("papaye","orange","banane","ananas"); - sort($fruits); - for(reset($fruits); $key = key($fruits); next($fruits)) { - echo "fruits[$key] = ".$fruits[$key]."\n"; + sort ($fruits); + reset ($fruits); + while (list ($key, $val) = each ($fruits)) { + echo "fruits[".$key."] = ".$val."\n"; } -?&gt; +?> +]]> </programlisting> </example> Cet exemple va afficher : <computeroutput> - fruits[0] = ananas - fruits[1] = banane - fruits[2] = orange - fruits[3] = papaye +<![CDATA[ +fruits[0] = ananas +fruits[1] = banane +fruits[2] = orange +fruits[3] = papaye +]]> </computeroutput> Les fruits ont &eacute;t&eacute; class&eacute;s dans l'ordre alphab&eacute;tique. </para> + <para> + Le param&egrave;tre optionel <parameter>sort_flags</parameter> + peut &ecirc;tre utilis&eacute; pour modifier le comportement de trie en + utilisant ces valeurs : + </para> + <para> + Constantes de type de tri : + <itemizedlist> + <listitem> + <simpara>SORT_REGULAR - compare les &eacute;l&eacute;ments normalement</simpara> + </listitem> + <listitem> + <simpara>SORT_NUMERIC - compare les &eacute;l&eacute;ments num&eacute;riquement</simpara> + </listitem> + <listitem> + <simpara>SORT_STRING - compare les &eacute;l&eacute;ments comme des cha&icirc;nes de caract&egrave;res</simpara> + </listitem> + </itemizedlist> + </para> + <note> + <para> + Le second param&egrave;tre a &eacute;t&eacute; ajout&eacute; en PHP 4. + </para> + </note> <para> Voir aussi <function>array-multisort</function>, Index: phpdoc-fr/reference/array/functions/uasort.xml diff -u phpdoc-fr/reference/array/functions/uasort.xml:1.1 phpdoc-fr/reference/array/functions/uasort.xml:1.2 --- phpdoc-fr/reference/array/functions/uasort.xml:1.1 Sun Apr 14 20:22:08 2002 +++ phpdoc-fr/reference/array/functions/uasort.xml Tue Feb 4 12:46:06 2003 @@ -5,23 +5,41 @@ <refnamediv> <refname>uasort</refname> <refpurpose> - Trie d'un tableau en utilisant une fonction de comparaison d&eacute;finie par - l'utilisateur. + Trie un tableau en utilisant une fonction de comparaison personnalis&eacute;e </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>uasort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>uasort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> <para> - <function>uasort</function> trie un tableau en conservant la correspondance entre les index - et leurs valeurs. <function>uasort</function> sert essentiellement lors de tri de tableaux + <function>uasort</function> trie le tableau <parameter>array</parameter> + en conservant la correspondance entre les index et leurs valeurs. + <function>uasort</function> sert essentiellement lors de tri de tableaux associatifs o&ugrave; l'ordre des &eacute;l&eacute;ments est significatif. La - fonction de comparaison utilis&eacute;e est d&eacute;finie par l'utilisateur. + fonction de comparaison utilis&eacute;e <parameter>cmp_function</parameter> + est d&eacute;finie par l'utilisateur. </para> + <note> + <para> + Voyez les fonctions <function>usort</function> et + <function>uksort</function> pour des exemples de tris avec utilisation + de fonction personnalis&eacute;e. + </para> + </note> + <para> + Voir aussi + <function>usort</function>, + <function>uksort</function>, + <function>sort</function>, + <function>asort</function>, + <function>arsort</function>, + <function>ksort</function> et + <function>rsort</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/array/functions/uksort.xml diff -u phpdoc-fr/reference/array/functions/uksort.xml:1.2 phpdoc-fr/reference/array/functions/uksort.xml:1.3 --- phpdoc-fr/reference/array/functions/uksort.xml:1.2 Sun Sep 8 17:42:07 2002 +++ phpdoc-fr/reference/array/functions/uksort.xml Tue Feb 4 12:46:06 2003 @@ -11,11 +11,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>uksort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>uksort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> <para> <function>uksort</function> trie les cl&eacute;s du tableau en utilisant une fonction d&eacute;finie par l'utilisateur. Si un tableau doit &ecirc;tre @@ -26,25 +26,30 @@ <programlisting role="php"> <![CDATA[ <?php - function mycompare($a, $b) { +function compare ($a, $b) { if ($a == $b) return 0; - return ($a &gt; $b) ? -1 : 1; - } - $a = array(4 => "quatre", 3 => "trois", 20 => "vingt", 10 => "dix"); - uksort($a, mycompare); - while(list($key, $value) = each($a)) { + return ($a > $b) ? -1 : 1; +} + +$a = array (4 => "quatre", 3 => "trois", 20 => "vingt", 10 => "dix"); + +uksort ($a, "compare"); + +while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; - } +} ?> ]]> </programlisting> </example> Cet exemple affichera: <computeroutput> - 20: vingt - 10: dix - 4: quatre - 3: trois +<![CDATA[ +20: vingt +10: dix +4: quatre +3: trois +]]> </computeroutput> </para> <para> Index: phpdoc-fr/reference/array/functions/usort.xml diff -u phpdoc-fr/reference/array/functions/usort.xml:1.2 phpdoc-fr/reference/array/functions/usort.xml:1.3 --- phpdoc-fr/reference/array/functions/usort.xml:1.2 Sun Sep 8 17:42:07 2002 +++ phpdoc-fr/reference/array/functions/usort.xml Tue Feb 4 12:46:06 2003 @@ -5,19 +5,19 @@ <refnamediv> <refname>usort</refname> <refpurpose> - Trie un tableau en utilisant une fonction de comparaison d&eacute;finie - par l'utilisateur + Trie un tableau en utilisant une fonction de comparaison personnalis&eacute;e </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>usort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>usort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> <para> - <function>usort</function> va trier un tableau avec ses valeurs, en utilisant une fonction + <function>usort</function> va trier le tableau <parameter>array</parameter> + avec ses valeurs, en utilisant une fonction d&eacute;finie par l'utilisateur. Si un tableau doit &ecirc;tre tri&eacute; avec un crit&egrave;re complexe, il est pr&eacute;f&eacute;rable d'utiliser cette m&eacute;thode. @@ -28,31 +28,45 @@ suivant que le premier argument est consid&eacute;r&eacute; comme plus petit, &eacute;gal ou plus grand que le second argument. Si les deux arguments sont &eacute;gaux, leur ordre est ind&eacute;fini. + <note> + <para> + Si deux &eacute;lments sont &eacute;gaux, au sens de la fonction <parameter>cmp_function</parameter>, + leur ordre sera ind&eacute;fini. Jusqu'en &php; 4.0.6, la fonction de tri + leur conserverait leur ordre original, mais le nouvel algorithme introduit + en &php; 4.1.0 fait que ce n'est plus le cas, car cela serait trop + co&ucirc;teux. + </para> + </note> <example> <title>Exemple avec <function>usort</function></title> <programlisting role="php"> <![CDATA[ <?php - function cmp($a,$b) { +function compare ($a, $b) { if ($a == $b) return 0; - return ($a &lt; $b) ? -1 : 1; - } - $tableau = array(3,2,5,6,1); - usort($a, "cmp"); - while(list($cle,$valeur) = each($tableau)) { - echo "$cle: $valeur\n"; - } + return ($a > $b) ? -1 : 1; +} + +$a = array (3, 2, 5, 6, 1); + +usort ($a, "compare"); + +while (list ($key, $value) = each ($a)) { + echo "$key: $value\n"; +} ?> ]]> </programlisting> </example> Cet exemple va afficher : <computeroutput> - 0: 6 - 1: 5 - 2: 3 - 3: 2 - 4: 1 +<![CDATA[ +0: 6 +1: 5 +2: 3 +3: 2 +4: 1 +]]> </computeroutput> <note> <para> @@ -60,27 +74,115 @@ appropri&eacute;. </para> </note> - <warning> + </para> + <para> - Les biblioth&egrave;ques de tri rapides sur lesquelles reposent PHP - peuvent le conduire &agrave; un plantage, si la fonction de comparaison - ne retourne pas une valeur coh&eacute;rente. + <example> + <title> + Tri avec <function>usort</function> sur un tableau multi-dimensionnel + </title> + <programlisting role="php"> +<![CDATA[ +<?php +function compare($a, $b) { + return strcmp($a["fruit"], $b["fruit"]); +} + +$fruits[0]["fruit"] = "citron"; +$fruits[1]["fruit"] = "pommes"; +$fruits[2]["fruit"] = "raisins"; + +usort($fruits, "cmp"); + +while (list ($key, $value) = each ($fruits)) { + echo "\$fruits[$key]: " . $value["fruit"] . "\n"; +} +?> +]]> + </programlisting> + </example> </para> - </warning> - </para> + <para> + Lors du tri de tableau multi dimensionnel, <varname>$a</varname> et + <varname>$b</varname> contiennent des r&eacute;f&eacute;rences sur le premier + &eacute;l&eacute;ment du tableau. + </para> + <para> + Cet exemple va afficher : + </para> + <para> + <screen> +<![CDATA[ +$fruits[0]: raisins +$fruits[1]: pommes +$fruits[2]: citron +]]> + </screen> + </para> + + <para> + <example> + <title> + Tri avec <function>usort</function> sur un objet + </title> + <programlisting role="php"> +<![CDATA[ +<?php +class TestObj { + var $name; + + function TestObj($name) + { + $this->name = $name; + } + + /* Ceci est une fonction de comparaison statique */ + function cmp_obj($a, $b) + { + $al = strtolower($a->name); + $bl = strtolower($b->name); + if ($al == $bl) return 0; + return ($al > $bl) ? +1 : -1; + } +} + +$a[] = new TestObj("c"); +$a[] = new TestObj("b"); +$a[] = new TestObj("d"); + +uasort($a, array ("TestObj", "cmp_obj")); + +foreach ($a as $item) { + print $item->name."\n"; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + Cet exemple va afficher : + </para> + <para> + <screen> +<![CDATA[ +b +c +d +]]> + </screen> + </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> et - <function>uksort</function>. + <function>uasort</function>, + <function>uksort</function>, + <function>sort</function>, + <function>asort</function>, + <function>arsort</function>, + <function>ksort</function>, + <function>natsort</function> et + <function>rsort</function>. </para> </refsect1> </refentry>
« previous php.doc.fr (#202) next »