cvs: phpdoc /fr/functions array.xml
| From: | Damien Seguy | Date: | Mon, 29 Oct 2001 19:15:32 +0000 |
| Subject: | cvs: phpdoc /fr/functions array.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338314@lists.php.net to get a copy of this message | ||
dams Mon Oct 29 14:15:32 2001 EDT
Modified files:
/phpdoc/fr/functions array.xml
Log:
Added array fill, corrected some typos.
Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.41 phpdoc/fr/functions/array.xml:1.42 --- phpdoc/fr/functions/array.xml:1.41 Fri Aug 10 08:59:15 2001 +++ phpdoc/fr/functions/array.xml Mon Oct 29 14:15:32 2001 @@ -1,12 +1,14 @@ -<!-- $Revision: 1.41 $ --> +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.42 $ --> <reference id="ref.array"> <title>Tableaux</title> <titleabbrev>Tableaux</titleabbrev> <partintro> <simpara> Ces fonctions vous permettent de manipuler et de traiter les tableaux - de nombreuses façons. Les tableaux sont très efficaces dès - qu'il s'agit de stocker, gérer et traiter des données en groupe. + de nombreuses façons. Les tableaux sont très efficaces + dès qu'il s'agit de stocker, gérer et traiter des + données en groupe. </simpara> <simpara> Les tableaux simples et multi-dimensionnels sont supportés et peuvent @@ -217,9 +219,23 @@ </para> <para> <varname>$result</varname> contient <literal>array("bleu");</literal>. - Les valeurs multiples dans $array1 seront toutes traitées de la même - façon. + Les valeurs multiples dans $array1 seront toutes traitées de la + même façon. </para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> Voir aussi <function>array_intersect</function>. @@ -302,12 +318,20 @@ clés sont les valeurs du précédent tableau, et les valeurs sont les clés. <function>array_flip</function> ne fonctionne que sur des entiers et des chaînes, et affichera une - erreur s'il détecte une clé ou une valeur de type invalide (tableau, - objet, booléen, nombre à virgule flottante). + erreur s'il détecte une clé ou une valeur de type invalide + (tableau, objet, booléen, nombre à virgule flottante). + </para> + <para> + Notez bien que les valeurs de <parameter>trans</parameter> doivent + être des clés valides, c'est à dire qu'elles doivent être des + entiers (<type>integer</type>) ou des chaînes de caractères + (<type>string</type>). Une alerte sera émise si une valeur a un type qui + ne convient pas et la paire en question <emphasis>ne sera pas + inversée</emphasis>. </para> <para> - Si une valeur n'est pas unique, seule la dernière clé sera utilisée - comme valeur, et toutes les autres seront perdues. + Si une valeur n'est pas unique, seule la dernière clé sera + utilisée comme valeur, et toutes les autres seront perdues. </para> <para> <function>array_flip</function> retourne &false; @@ -344,6 +368,50 @@ </note> </refsect1> </refentry> + <refentry id="function.array-fill"> + <refnamediv> + <refname>array_fill</refname> + <refpurpose>Remplis un tableau avec une même valeur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>array_fill</function></funcdef> + <paramdef>int <parameter>start_index</parameter></paramdef> + <paramdef>int <parameter>num</parameter></paramdef> + <paramdef>mixed <parameter>value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>array_fill</function> crée un tableau avec + <parameter>num</parameter> entrées de la valeur + <parameter>value</parameter>. Les index commecent à la valeur + <parameter>start_index</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>array_fill</function></title> + <programlisting role="php"> +<?gt; +$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"; +*/ +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <refentry id="function.array-intersect"> <refnamediv> <refname>array_intersect</refname> @@ -367,7 +435,21 @@ qui sont présentes dans tous les autres arguments. Notez que les clés sont préservées. </para> - <para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> + <para> <example> <title>Exemple avec <function>array_intersect</function></title> <programlisting role="php"> @@ -380,7 +462,8 @@ </example> </para> <para> - <varname>$result</varname> contient <literal>array ("a" => "vert", "rouge");</literal>. + <varname>$result</varname> contient <literal>array ("a" => "vert", + "rouge");</literal>. </para> <para> Voir aussi @@ -407,8 +490,8 @@ </funcprototype> </funcsynopsis> <para> - <function>array_keys</function> retourne les clés numériques et - littérales du tableau <parameter>input</parameter>. + <function>array_keys</function> retourne les clés numériques + et litérales du tableau <parameter>input</parameter>. </para> <para> Si l'option <parameter>search_value</parameter> est spécifiée, @@ -437,8 +520,8 @@ </para> <note> <para> - <function>array_keys</function> a été ajoutée en PHP 4. - Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: + <function>array_keys</function> a été ajoutée en PHP + 4. Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: <example> <title> Implémentation de <function>array_keys</function> pour @@ -449,11 +532,12 @@ function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { - if ($term && $v != $term) + if ($term && $v != $term) { continue; $t[] = $k; } return $t; + } } ?> </programlisting> @@ -1206,8 +1290,9 @@ </funcsynopsis> <para> <function>array_shift</function> extrait la première valeur d'un - tableau et la retourne, en raccourcissant le tableau d'un élément, - et en déplacant tous les éléments vers le bas. + tableau et la retourne, en raccourcissant le tableau d'un + élément, et en déplacant tous les + éléments vers le bas. Si <parameter>array</parameter> est vide, ou n'est pas un tableau, <function>array_shift</function> retourne &null;. </para> @@ -1231,7 +1316,8 @@ <function>array_pop</function>. <note> <para> - <function>array_shift</function> a été ajoutée en PHP 4.0. + <function>array_shift</function> a été ajoutée en PHP + 4.0. </para> </note> </para> @@ -1485,10 +1571,24 @@ <parameter>array</parameter> et retourne un nouveau tableau, complètement dédoublonné. </para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> Notez que les clés sont préservées. - <function>array_unique</function> conserve la clé de la première - valeur rencontrée, et ignore toutes les suivantes. + <function>array_unique</function> conserve la clé de la + première valeur rencontrée, et ignore toutes les suivantes. </para> <para> <example> @@ -1509,6 +1609,7 @@ </programlisting> </example> </para> +<!-- <para> Notez aussi que <function>array_unique</function> tient compte du type de la valeur. Cela ne porte généralement pas à @@ -1516,6 +1617,7 @@ peuvent être de différents types. Cela conduit à des résultats déroutants. </para> +--> <para> <example> <title><function>array_unique</function> et les types de valeurs</title> @@ -1579,8 +1681,8 @@ ?> </programlisting> </example> - Le résultat de cet exemple est que $queue aura 5 éléments, - à savoir: "p4", "p5", "p6", "p1", et "p3". + Le résultat de cet exemple est que $queue aura 5 + éléments, à savoir: "p4", "p5", "p6", "p1", et "p3". </para> <para> Voir aussi @@ -1589,7 +1691,8 @@ <function>array_pop</function>. <note> <para> - <function>array_unshift</function> a été ajoutée en PHP 4.0. + <function>array_unshift</function> a été ajoutée en + PHP 4.0. </para> </note> </para> @@ -1927,10 +2030,9 @@ (et tout le reste n'aura qu'un élément). </para> <para> - <function>count</function> retourne 1 si la variable n'est pas un tableau. - </para> - <para> - <function>count</function> retourne 0 si la variable n'est pas créée. + If <parameter>var</parameter> n'est pas un tableau, <literal>1</literal> + sera retourné (exception : <literal>count(&null;)</literal> égale + <literal>0</literal>). </para> <para> <warning>
Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.41 phpdoc/fr/functions/array.xml:1.42 --- phpdoc/fr/functions/array.xml:1.41 Fri Aug 10 08:59:15 2001 +++ phpdoc/fr/functions/array.xml Mon Oct 29 14:15:32 2001 @@ -1,12 +1,14 @@ -<!-- $Revision: 1.41 $ --> +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.42 $ --> <reference id="ref.array"> <title>Tableaux</title> <titleabbrev>Tableaux</titleabbrev> <partintro> <simpara> Ces fonctions vous permettent de manipuler et de traiter les tableaux - de nombreuses façons. Les tableaux sont très efficaces dès - qu'il s'agit de stocker, gérer et traiter des données en groupe. + de nombreuses façons. Les tableaux sont très efficaces + dès qu'il s'agit de stocker, gérer et traiter des + données en groupe. </simpara> <simpara> Les tableaux simples et multi-dimensionnels sont supportés et peuvent @@ -217,9 +219,23 @@ </para> <para> <varname>$result</varname> contient <literal>array("bleu");</literal>. - Les valeurs multiples dans $array1 seront toutes traitées de la même - façon. + Les valeurs multiples dans $array1 seront toutes traitées de la + même façon. </para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> Voir aussi <function>array_intersect</function>. @@ -302,12 +318,20 @@ clés sont les valeurs du précédent tableau, et les valeurs sont les clés. <function>array_flip</function> ne fonctionne que sur des entiers et des chaînes, et affichera une - erreur s'il détecte une clé ou une valeur de type invalide (tableau, - objet, booléen, nombre à virgule flottante). + erreur s'il détecte une clé ou une valeur de type invalide + (tableau, objet, booléen, nombre à virgule flottante). + </para> + <para> + Notez bien que les valeurs de <parameter>trans</parameter> doivent + être des clés valides, c'est à dire qu'elles doivent être des + entiers (<type>integer</type>) ou des chaînes de caractères + (<type>string</type>). Une alerte sera émise si une valeur a un type qui + ne convient pas et la paire en question <emphasis>ne sera pas + inversée</emphasis>. </para> <para> - Si une valeur n'est pas unique, seule la dernière clé sera utilisée - comme valeur, et toutes les autres seront perdues. + Si une valeur n'est pas unique, seule la dernière clé sera + utilisée comme valeur, et toutes les autres seront perdues. </para> <para> <function>array_flip</function> retourne &false; @@ -344,6 +368,50 @@ </note> </refsect1> </refentry> + <refentry id="function.array-fill"> + <refnamediv> + <refname>array_fill</refname> + <refpurpose>Remplis un tableau avec une même valeur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>array_fill</function></funcdef> + <paramdef>int <parameter>start_index</parameter></paramdef> + <paramdef>int <parameter>num</parameter></paramdef> + <paramdef>mixed <parameter>value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>array_fill</function> crée un tableau avec + <parameter>num</parameter> entrées de la valeur + <parameter>value</parameter>. Les index commecent à la valeur + <parameter>start_index</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>array_fill</function></title> + <programlisting role="php"> +<?gt; +$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"; +*/ +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <refentry id="function.array-intersect"> <refnamediv> <refname>array_intersect</refname> @@ -367,7 +435,21 @@ qui sont présentes dans tous les autres arguments. Notez que les clés sont préservées. </para> - <para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> + <para> <example> <title>Exemple avec <function>array_intersect</function></title> <programlisting role="php"> @@ -380,7 +462,8 @@ </example> </para> <para> - <varname>$result</varname> contient <literal>array ("a" => "vert", "rouge");</literal>. + <varname>$result</varname> contient <literal>array ("a" => "vert", + "rouge");</literal>. </para> <para> Voir aussi @@ -407,8 +490,8 @@ </funcprototype> </funcsynopsis> <para> - <function>array_keys</function> retourne les clés numériques et - littérales du tableau <parameter>input</parameter>. + <function>array_keys</function> retourne les clés numériques + et litérales du tableau <parameter>input</parameter>. </para> <para> Si l'option <parameter>search_value</parameter> est spécifiée, @@ -437,8 +520,8 @@ </para> <note> <para> - <function>array_keys</function> a été ajoutée en PHP 4. - Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: + <function>array_keys</function> a été ajoutée en PHP + 4. Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3: <example> <title> Implémentation de <function>array_keys</function> pour @@ -449,11 +532,12 @@ function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { - if ($term && $v != $term) + if ($term && $v != $term) { continue; $t[] = $k; } return $t; + } } ?> </programlisting> @@ -1206,8 +1290,9 @@ </funcsynopsis> <para> <function>array_shift</function> extrait la première valeur d'un - tableau et la retourne, en raccourcissant le tableau d'un élément, - et en déplacant tous les éléments vers le bas. + tableau et la retourne, en raccourcissant le tableau d'un + élément, et en déplacant tous les + éléments vers le bas. Si <parameter>array</parameter> est vide, ou n'est pas un tableau, <function>array_shift</function> retourne &null;. </para> @@ -1231,7 +1316,8 @@ <function>array_pop</function>. <note> <para> - <function>array_shift</function> a été ajoutée en PHP 4.0. + <function>array_shift</function> a été ajoutée en PHP + 4.0. </para> </note> </para> @@ -1485,10 +1571,24 @@ <parameter>array</parameter> et retourne un nouveau tableau, complètement dédoublonné. </para> + <note> + <simpara> + Deux éléments sont considérés comme égaux si et seulement si + <literal>(string) $elem1 === (string) $elem2</literal>. En clair : + lorsque la représentation en chaîne de caractères est identique. + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + Cette fonction était inutilisable en PHP 4.0.4! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> Notez que les clés sont préservées. - <function>array_unique</function> conserve la clé de la première - valeur rencontrée, et ignore toutes les suivantes. + <function>array_unique</function> conserve la clé de la + première valeur rencontrée, et ignore toutes les suivantes. </para> <para> <example> @@ -1509,6 +1609,7 @@ </programlisting> </example> </para> +<!-- <para> Notez aussi que <function>array_unique</function> tient compte du type de la valeur. Cela ne porte généralement pas à @@ -1516,6 +1617,7 @@ peuvent être de différents types. Cela conduit à des résultats déroutants. </para> +--> <para> <example> <title><function>array_unique</function> et les types de valeurs</title> @@ -1579,8 +1681,8 @@ ?> </programlisting> </example> - Le résultat de cet exemple est que $queue aura 5 éléments, - à savoir: "p4", "p5", "p6", "p1", et "p3". + Le résultat de cet exemple est que $queue aura 5 + éléments, à savoir: "p4", "p5", "p6", "p1", et "p3". </para> <para> Voir aussi @@ -1589,7 +1691,8 @@ <function>array_pop</function>. <note> <para> - <function>array_unshift</function> a été ajoutée en PHP 4.0. + <function>array_unshift</function> a été ajoutée en + PHP 4.0. </para> </note> </para> @@ -1927,10 +2030,9 @@ (et tout le reste n'aura qu'un élément). </para> <para> - <function>count</function> retourne 1 si la variable n'est pas un tableau. - </para> - <para> - <function>count</function> retourne 0 si la variable n'est pas créée. + If <parameter>var</parameter> n'est pas un tableau, <literal>1</literal> + sera retourné (exception : <literal>count(&null;)</literal> égale + <literal>0</literal>). </para> <para> <warning>