cvs: phpdoc /fr/functions array.xml

From: Date: Tue, 12 Dec 2000 10:48:50 +0000
Subject: cvs: phpdoc /fr/functions array.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333207@lists.php.net to get a copy of this message
dams Tue Dec 12 02:48:50 2000 EDT Modified files: /phpdoc/fr/functions array.xml Log: Rereading translation.

Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.11 phpdoc/fr/functions/array.xml:1.12 --- phpdoc/fr/functions/array.xml:1.11 Thu Nov 30 02:27:08 2000 +++ phpdoc/fr/functions/array.xml Tue Dec 12 02:48:49 2000 @@ -38,26 +38,27 @@ </funcprototype> </funcsynopsis> <para> - <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>. + <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> 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. + <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> - 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. + 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, @@ -97,9 +98,10 @@ ) </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. + 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. @@ -154,7 +156,8 @@ </example> <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_count_values</function> a &eacute;t&eacute; ajout&eacute;e + dans PHP 4.0. </para> </note> </para> @@ -194,8 +197,7 @@ </example> </para> <para> - <varname>$result</varname> contient <literal>array - ("bleu");</literal> + <varname>$result</varname> contient <literal>array("bleu");</literal> </para> <para> Voir aussi <function>array_intersect</function>. @@ -229,7 +231,7 @@ </example> <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_flip</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -315,12 +317,12 @@ </para> <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4. Ci dessous, voici une - impl&eacute;mentation qui fonctionnera sous PHP3: + <function>array_keys</function> a &eacute;t&eacute; ajout&eacute;e dans 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 + Impl&eacute;mentation de <function>array_keys</function> pour + les utilisateurs de PHP 3 </title> <programlisting role="php"> function array_keys ($arr, $term="") { @@ -382,7 +384,8 @@ </example> <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_merge</function> a &eacute;t&eacute; ajout&eacute;e dans + PHP 4.0. </para> </note> </para> @@ -406,19 +409,23 @@ </funcprototype> </funcsynopsis> <para> - <function>array_merge_recursive</function> rassemble tous les &eacute;l&eacute;ments - de plusieurs tableaux ensemble, en ajoutant les &eacute;l&eacute;ments de l'un &agrave; la - suite des &eacute;l&eacute;m&eacute;nts du pr&eacute;c&eacute;dent. Cette fonction retourne le tableau + <function>array_merge_recursive</function> rassemble tous les + &eacute;l&eacute;ments de plusieurs tableaux ensemble, en ajoutant les + &eacute;l&eacute;ments de l'un &agrave; la suite des + &eacute;l&eacute;m&eacute;nts du pr&eacute;c&eacute;dent. + <function>array_merge_recursive</function> retourne le tableau r&eacute;sultant. </para> <para> - Si les tableaux pass&eacute;s en arguments ont les m&ecirc;mes cl&eacute;s (cha&icirc;nes de - caract&egrave;res), les valeurs sont alors rassembl&eacute;es dans un tableau, - de mani&egrave;re r&eacute;cursive, de fa&ccedil;on &agrave; ce que, si l'une de ces valeurs - est un tableau elle-m&ecirc;me, la fonction la rassemblera avec les valeurs - de l'entr&eacute;e courante. Cependant, si deux tableaux ont la m&ecirc;me cl&eacute; - num&eacute;rique, la derni&egrave;re valeur n'&eacute;crasera pas la pr&eacute;c&eacute;dente, mais sera - ajout&eacute; &agrave; la fin du tableau. + Si les tableaux pass&eacute;s en arguments ont les m&ecirc;mes cl&eacute;s + (cha&icirc;nes de caract&egrave;res), les valeurs sont alors + rassembl&eacute;es dans un tableau, de mani&egrave;re r&eacute;cursive, + de fa&ccedil;on &agrave; ce que, si l'une de ces valeurs est un tableau + elle-m&ecirc;me, la fonction la rassemblera avec les valeurs de + l'entr&eacute;e courante. Cependant, si deux tableaux ont la m&ecirc;me + cl&eacute; num&eacute;rique, la derni&egrave;re valeur n'&eacute;crasera + pas la pr&eacute;c&eacute;dente, mais sera ajout&eacute; &agrave; la fin + du tableau. </para> <para> <example> @@ -475,10 +482,10 @@ et ainsi de suite... </para> <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 - deux options de tri, prises dans les valeurs suivantes : + La structure des arguments de <function>array_multisort</function> 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 deux options de tri, prises dans les valeurs suivantes : </para> <para> Options de tri : @@ -629,7 +636,7 @@ <function>array_unshift</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_pop</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -683,7 +690,7 @@ <function>array_unshift</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_push</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -719,7 +726,7 @@ Au final, $result contient (array ("rouge", "vert"), 4.0, "php"). <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0 Beta 3. + <function>array_reverse</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0 Beta 3. </para> </note> </para> @@ -809,7 +816,7 @@ <function>array_pop</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_shift</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -870,7 +877,7 @@ Voir aussi <function>array_splice</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_slice</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -969,7 +976,7 @@ Voir aussi <function>array_slice</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_splice</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -1058,7 +1065,7 @@ <function>array_pop</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_unshift</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -1089,8 +1096,9 @@ </example> <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4. Ci dessous, voici une - impl&eacute;mentation pour ceux qui utilisent toujours PHP 3. + <function>array_values</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4. + Ci dessous, voici une impl&eacute;mentation pour ceux qui utilisent + toujours PHP 3. <example> <title> Impl&eacute;mentation de <function>array_values</function> pour les utilisateurs @@ -1195,10 +1203,10 @@ <paramdef>array <parameter>array</parameter></paramdef> </funcsynopsis> <para> - Cette fonction trie un tableau de telle mani&egrave;re que la corr&eacute;lation - entre les index et les valeurs soient conserv&eacute;es. L'usage principal est - lors de tri de tableaux associatifs o&uacute; l'ordre des &eacute;l&eacute;ments - est important. + <function>arsort</function> trie un tableau de telle mani&egrave;re + que la corr&eacute;lation entre les index et les valeurs soient + conserv&eacute;es. L'usage principal est lors de tri de tableaux + associatifs o&uacute; l'ordre des &eacute;l&eacute;ments est important. <example> <title>Exemple avec <function>arsort</function></title> <programlisting role="php"> @@ -1237,10 +1245,10 @@ <paramdef>array <parameter>array</parameter></paramdef> </funcsynopsis> <para> - Cette fonction trie un tableau de telle mani&egrave;re que la corr&eacute;lation - entre les index et les valeurs soient conserv&eacute;es. L'usage principal est - lors de tri de tableaux associatifs o&uacute; l'ordre des &eacute;l&eacute;ments - est important. + <function>asort</function> trie un tableau de telle mani&egrave;re que + la corr&eacute;lation entre les index et les valeurs soient conserv&eacute;es. + L'usage principal est lors de tri de tableaux associatifs o&uacute; l'ordre + des &eacute;l&eacute;ments est important. <example> <title>Exemple avec <function>asort</function></title> <programlisting role="php"> @@ -1317,7 +1325,7 @@ Voir aussi <function>extract</function>. <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>compact</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -1406,7 +1414,7 @@ <warning> <para> Si le tableau des &eacute;l&eacute;ments vides ou des z&eacute;ros (0 ou "", - la cha&icirc;ne vide) alors cette fonction retournera FALSE pour ces + la cha&icirc;ne vide) alors <function>current</function> retournera FALSE pour ces &eacute;l&eacute;ments. Il est donc impossible de determiner si vous &ecirc;tes r&eacute;ellement &agrave; la fin de la liste en utilisant la fonction <function>current</function>. Pour passer en revue proprement un @@ -1553,10 +1561,10 @@ </paramdef> </funcsynopsis> <para> - Cette fonction sert &agrave; exporter un tableau vers la table des symboles. + <function>extract</function> sert &agrave; exporter un tableau vers la table des symboles. Elle prend un tableau associatif <parameter>var_array</parameter> et cr&eacute;e les variables dont les noms sont les index de ce tableau, et leur affecte la - valeur associ&eacute;e. Pour chaque paire cl&eacute;/valeur, cette fonction + valeur associ&eacute;e. Pour chaque paire cl&eacute;/valeur, <function>extract</function> cr&eacute;e une variable, avec les param&egrave;tres <parameter>extract_type</parameter> et <parameter>prefix</parameter>. </para> @@ -1617,7 +1625,7 @@ exportation. </para> <para> - Une utilisation possible de cette fonction est l'exportation vers la table des + Une utilisation possible de <function>extract</function> est l'exportation vers la table des symboles de tableau de variables retourn&eacute; par la fonction <function>wddx_deserialize</function>. </para> @@ -1684,7 +1692,7 @@ </example> <note> <para> - Cette fonction a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>in_array</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. </para> </note> </para> @@ -1863,7 +1871,7 @@ </funcprototype> </funcsynopsis> <para> - Cette fonction impl&eacute;mente un algorithme de tri qui traite + <function>natsort</function> impl&eacute;mente un algorithme de tri qui traite les cha&icirc;nes alphanum&eacute;riques comme un &ecirc;tre humain : c'est ce qui est appel&eacute; l'"ordre naturel". Un exemple de la diff&eacute;rence de traitement entre un tel algorithme et un @@ -1935,7 +1943,7 @@ </funcprototype> </funcsynopsis> <para> - Cette fonction impl&eacute;mente un algorithme de tri qui traite + <function>natcasesort</function> impl&eacute;mente un algorithme de tri qui traite les cha&icirc;nes alphanum&eacute;riques comme un &ecirc;tre humain : c'est ce qui est appel&eacute; l'"ordre naturel". </para> @@ -1984,7 +1992,7 @@ <warning> <para> Si le tableau contient des &eacute;l&eacute;ments vides ou des z&eacute;ros, - cette fonction retournera FALSE pour ces &eacute;l&eacute;ments. + <function>next</function> retournera FALSE pour ces &eacute;l&eacute;ments. Pour passer proprement en revue un tableau, il faut utiliser <function>each</function>. </para> @@ -2035,8 +2043,8 @@ d'&eacute;l&eacute;ments. <warning> <para> - Si le tableau contient des &eacute;l&eacute;ments vides, cette fonction - retournera faux pour ces &eacute;l&eacute;ments aussi. Pour passer en + Si le tableau contient des &eacute;l&eacute;ments vides, <function>prev</function> + retournera FALSE pour ces &eacute;l&eacute;ments aussi. Pour passer en revue tous les &eacute;l&eacute;ments, utilisez plut&ocirc;t <function>each</function>. </para> @@ -2116,7 +2124,7 @@ <paramdef>array <parameter>array</parameter></paramdef> </funcsynopsis> <para> - Cette fonction effectue un trie en ordre d&eacute;croissant (du plus grand au + <function>rsort</function> effectue un trie en ordre d&eacute;croissant (du plus grand au plus petit). <example> <title>Exemple avec <function>rsort</function></title> @@ -2157,7 +2165,8 @@ <paramdef>array <parameter>array</parameter></paramdef> </funcsynopsis> <para> -Cette fonction m&eacute;lange les &eacute;l&eacute;ments d'un tableau. + <function>shuffle</function> m&eacute;lange les &eacute;l&eacute;ments + d'un tableau. <example> <title>Exemple avec <function>shuffle</function></title> <programlisting role="php"> @@ -2208,7 +2217,7 @@ <paramdef>array <parameter>array</parameter></paramdef> </funcsynopsis> <para> - Cette fonction trie le tableau <parameter>array</parameter>. Les + <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> @@ -2252,8 +2261,8 @@ <paramdef>function <parameter>cmp_function</parameter></paramdef> </funcsynopsis> <para> - Cette fonction trie un tableau en conservant la correspondance entre les index - et leurs valeurs. Cette fonction sert essentiellement lors de tri de tableaux + <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 associatifs o&uacute; l'ordre des &eacute;l&eacute;ments est significatif. La fonction de comparaison utilis&eacute;e est d&eacute;finie par l'utilisateur. </para> @@ -2277,7 +2286,7 @@ <function>uksort</function> trie les cl&eacute;s du tableau en utilisant une fonction d&eacute;finie par l'utilisateur. Si un tableau qui doit &ecirc;tre tri&eacute; avec un crit&egrave;re complexe, il est pr&eacute;f&eacute;rable - d'utiliser cette fonction. + d'utiliser <function>uksort</function>. <example> <title>Exemple avec <function>uksort</function></title> <programlisting role="php"> @@ -2323,7 +2332,7 @@ <paramdef>function <parameter>cmp_function</parameter></paramdef> </funcsynopsis> <para> - Cette fonction va trier un tableau avec ses valeurs, en utilisant une fonction + <function>usort</function> va trier un tableau 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.
« previous php.doc (#969333207) next »