 |
 |
 |
 |
|
|
Date: 11/30/00
- Next message: Damien Seguy: "[PHP-DOC] cvs: phpdoc /fr/functions hw.xml"
- Previous message: Jesus M. Castagnetto: "[PHP-DOC] cvs: phpdoc /en/functions array.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
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éé à partir des paramètres
- fournis. Les paramètres peuvent avoir un index, fournis sous la forme
- clé <literal>=></literal> valeur.
+ <function>array</function> retourne un tableau créé avec les paramètres
+ passés. On peut attribuer un index particulier à une valeur avec
+ l'opérateur <literal>=></literal>.
</para>
<para>
<note>
<para>
- <function>array</function> n'est pas une fonction standard, elle existe
- simplement pour représenter litéralement des tableaux.
+ <function>array</function> est un élément de langage utilisé pour
+ représenter des tableaux lité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és pour les tableaux
- associatifs, et comment écarter certains intervalle d'indices
- numériques.
+ La syntaxe "index => values", séparés par des virgules, définit
+ les index et leur valeur. Un index peut être une chaîne ou un
+ nombre. Si l'index est omis, un index numérique sera automatiquement
+ généré (commençant à 0). Si l'index est un entier, le prochain
+ index généré prendra la valeur d'index la plus grande + 1. Notez que
+ si deux index identiques sont définis, le dernier remplacera le premier.
+ </para>
+ <para>
+ L'exemple suivant montre comment créer un tableau à deux dimensions,
+ comment spécifier les index d'un tableau associatif, et comment
+ générer automatiquement des index numé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ème", "troisième")
+ "fruits" => array ("a"=>"orange", "b"=>"banane", "c"=>"pomme"),
+ "numbers" => array (1, 2, 3, 4, 5, 6),
+ "holes" => array ("premier", 5 => "deuxième", "troisiè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éfini deux fois, et conserve finalement sa
+ dernière valeur de 13. L'index '4' est défini après l'index '8', et l'index
+ généré suivant (valeur 19) est 9, puisque le plus grand index est alors 8.
+ </para>
+ <para>
+ Cet exemple crée un tableau dont les index commence à 1.
+ <example>
+ <title>Tableau d'index commencant à 1</title>
+ <programlisting role="php">
+ $firstquarter = array(1 => 'Janvier', 'Février', 'Mars');
+ print_r($firstquarter);
+ </programlisting>
+ </example>
+ qui affichera :
+ <informalexample>
+ <programlisting>
+Array
+(
+ [1] => 'Janvier'
+ [2] => 'Fé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 être un tableau,
- mais les arguments suivants peuvent être des tableaux ou une ou
+ mais les arguments suivants peuvent ê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 être appliquée
- après un tableau. Une option ne s'applique qu'au tableau
- précédent. Tous les autres sont mis par défaut
+ Une seule option de tri de chaque type peut être appliquée
+ après un tableau. Une option ne s'applique qu'au tableau
+ précédent. Tous les autres sont mis par défaut
à SORT_ASC et SORT_REGULAR.
</para>
<para>
@@ -469,9 +525,9 @@
</example>
</para>
<para>
- Dans cet exemple, Dans cet exemple, après le tri, le premier
- tableau contient 10, "a", 100, 100; Le deuxième tableau
- contient 1, 1, 2, "3". Les entrées du second tableau
+ Dans cet exemple, Dans cet exemple, après le tri, le premier
+ tableau contient 10, "a", 100, 100; Le deuxième tableau
+ contient 1, 1, 2, "3". Les entrées du second tableau
correspondent aux valeurs jumelles du premier
tableau (100 et 100), sont aussi triées.
</para>
@@ -486,9 +542,9 @@
</example>
</para>
<para>
- Dans cet exemple, après le tri, le premier tableau contient
- 10, 100, 100, "a" (tri alphabétique, ordre croissant); Le
- deuxième tableau contient 1, 3, "2", 1 (tri
+ Dans cet exemple, après le tri, le premier tableau contient
+ 10, 100, 100, "a" (tri alphabétique, ordre croissant); Le
+ deuxième tableau contient 1, 3, "2", 1 (tri
numérique, ordre décroissant).
</para>
</refsect1>
- Next message: Damien Seguy: "[PHP-DOC] cvs: phpdoc /fr/functions hw.xml"
- Previous message: Jesus M. Castagnetto: "[PHP-DOC] cvs: phpdoc /en/functions array.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]