cvs: phpdoc /fr/functions array.xml

From: Date: Thu, 30 Nov 2000 10:27:08 +0000
Subject: cvs: phpdoc /fr/functions array.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333124@lists.php.net to get a copy of this message
dams Thu Nov 30 02:27:08 2000 EDT Modified files: /phpdoc/fr/functions array.xml Log: Adding index's examples. Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.10 phpdoc/fr/functions/array.xml:1.11 --- phpdoc/fr/functions/array.xml:1.10 Wed Nov 22 06:26:38 2000 +++ phpdoc/fr/functions/array.xml Thu Nov 30 02:27:08 2000 @@ -38,35 +38,91 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau, cr&eacute;&eacute; &agrave; partir des param&egrave;tres - fournis. Les param&egrave;tres peuvent avoir un index, fournis sous la forme - cl&eacute; <literal>=&gt;</literal> valeur. + <function>array</function> retourne un tableau cr&eacute;&eacute; avec les param&egrave;tres + pass&eacute;s. On peut attribuer un index particulier &agrave; une valeur avec + l'op&eacute;rateur <literal>=&gt;</literal>. </para> <para> <note> <para> - <function>array</function> n'est pas une fonction standard, elle existe - simplement pour repr&eacute;senter lit&eacute;ralement des tableaux. + <function>array</function> est un &eacute;l&eacute;ment de langage utilis&eacute; pour + repr&eacute;senter des tableaux lit&eacute;raux, et non pas une fonction au + sens strict du terme. </para> </note> </para> <para> - Les exemples suivants montrent la construction de tableaux - bi-dimensionnels, l'assignation de cl&eacute;s pour les tableaux - associatifs, et comment &eacute;carter certains intervalle d'indices - num&eacute;riques. + La syntaxe "index =&gt; values", s&eacute;par&eacute;s par des virgules, d&eacute;finit + les index et leur valeur. Un index peut &ecirc;tre une cha&icirc;ne ou un + nombre. Si l'index est omis, un index num&eacute;rique sera automatiquement + g&eacute;n&eacute;r&eacute; (commen&ccedil;ant &agrave; 0). Si l'index est un entier, le prochain + index g&eacute;n&eacute;r&eacute; prendra la valeur d'index la plus grande + 1. Notez que + si deux index identiques sont d&eacute;finis, le dernier remplacera le premier. + </para> + <para> + L'exemple suivant montre comment cr&eacute;er un tableau &agrave; deux dimensions, + comment sp&eacute;cifier les index d'un tableau associatif, et comment + g&eacute;n&eacute;rer automatiquement des index num&eacute;riques. <example> - <title>Exemples avec <function>array</function></title> + <title>Exemple avec <function>array</function></title> <programlisting role="php"> $fruits = array ( - "fruits" => array("a"=>"orange", "b"=>"banane", "c"=>"pomme"), - "numbres" => array(1, 2, 3, 4, 5, 6), - "trous" => array("premier", 5 => "deuxi&egrave;me", "troisi&egrave;me") + "fruits" =&gt; array ("a"=&gt;"orange", "b"=&gt;"banane", "c"=&gt;"pomme"), + "numbers" =&gt; array (1, 2, 3, 4, 5, 6), + "holes" =&gt; array ("premier", 5 =&gt; "deuxi&egrave;me", "troisi&egrave;me") ); </programlisting> </example> </para> <para> + <example> + <title>Index automatique d'un tableau avec <function>array</function></title> + <programlisting role="php"> +$array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); +print_r($array); + </programlisting> + </example> + qui affichera : + <informalexample> + <programlisting> +Array +( + [0] => 1 + [1] => 1 + [2] => 1 + [3] => 13 + [4] => 1 + [8] => 1 + [9] => 19 +) + </programlisting> + </informalexample> + Notez bien que l'index '3' est d&eacute;fini deux fois, et conserve finalement sa + derni&egrave;re valeur de 13. L'index '4' est d&eacute;fini apr&egrave;s l'index '8', et l'index + g&eacute;n&eacute;r&eacute; suivant (valeur 19) est 9, puisque le plus grand index est alors 8. + </para> + <para> + Cet exemple cr&eacute;e un tableau dont les index commence &agrave; 1. + <example> + <title>Tableau d'index commencant &agrave; 1</title> + <programlisting role="php"> + $firstquarter = array(1 => 'Janvier', 'F&eacute;vrier', 'Mars'); + print_r($firstquarter); + </programlisting> + </example> + qui affichera : + <informalexample> + <programlisting> +Array +( + [1] => 'Janvier' + [2] => 'F&eacute;vrier' + [3] => 'Mars' +) + </programlisting> + </informalexample> + </para> + <para> Voir aussi : <function>list</function>. </para> </refsect1> @@ -421,7 +477,7 @@ <para> La structure des arguments de cette fonction est un peu inhabituelle, mais elle est plus souple. Le premier argument DOIT &ecirc;tre un tableau, - mais les arguments suivants peuvent &ecirc;tre des tableaux ou une ou + mais les arguments suivants peuvent &ecirc;tre des tableaux ou une ou deux options de tri, prises dans les valeurs suivantes : </para> <para> @@ -450,9 +506,9 @@ </itemizedlist> </para> <para> - Une seule option de tri de chaque type peut &ecirc;tre appliqu&eacute;e - apr&egrave;s un tableau. Une option ne s'applique qu'au tableau - pr&eacute;c&eacute;dent. Tous les autres sont mis par d&eacute;faut + Une seule option de tri de chaque type peut &ecirc;tre appliqu&eacute;e + apr&egrave;s un tableau. Une option ne s'applique qu'au tableau + pr&eacute;c&eacute;dent. Tous les autres sont mis par d&eacute;faut &agrave; SORT_ASC et SORT_REGULAR. </para> <para> @@ -469,9 +525,9 @@ </example> </para> <para> - Dans cet exemple, Dans cet exemple, apr&egrave;s le tri, le premier - tableau contient 10, "a", 100, 100; Le deuxi&egrave;me tableau - contient 1, 1, 2, "3". Les entr&eacute;es du second tableau + Dans cet exemple, Dans cet exemple, apr&egrave;s le tri, le premier + tableau contient 10, "a", 100, 100; Le deuxi&egrave;me tableau + contient 1, 1, 2, "3". Les entr&eacute;es du second tableau correspondent aux valeurs jumelles du premier tableau (100 et 100), sont aussi tri&eacute;es. </para> @@ -486,9 +542,9 @@ </example> </para> <para> - Dans cet exemple, apr&egrave;s le tri, le premier tableau contient - 10, 100, 100, "a" (tri alphab&eacute;tique, ordre croissant); Le - deuxi&egrave;me tableau contient 1, 3, "2", 1 (tri + Dans cet exemple, apr&egrave;s le tri, le premier tableau contient + 10, 100, 100, "a" (tri alphab&eacute;tique, ordre croissant); Le + deuxi&egrave;me tableau contient 1, 3, "2", 1 (tri num&eacute;rique, ordre d&eacute;croissant). </para> </refsect1>

« previous php.doc (#969333124) next »