dams Tue Apr 17 07:31:42 2001 EDT
Modified files:
/phpdoc/fr/functions array.xml
Log:
ˇjoutˇ -> ajoutˇ
Index: phpdoc/fr/functions/array.xml
diff -u phpdoc/fr/functions/array.xml:1.29 phpdoc/fr/functions/array.xml:1.30
--- phpdoc/fr/functions/array.xml:1.29 Wed Mar 28 08:00:29 2001
+++ phpdoc/fr/functions/array.xml Tue Apr 17 07:31:42 2001
@@ -1,72 +1,75 @@
- <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.
- </simpara>
- <simpara>
- Les tableaux simples et multi-dimensionnels sont supportés et peuvent
- être créé par l'utilisateur, ou par une fonction. Il y a
- des fonctions spécifiques qui remplissent des tableaux à partir
- de résultats de requêtes, et de nombreuses fonctions retournent
- un tableau.
- </simpara>
+<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.
+ </simpara>
+ <simpara>
+ Les tableaux simples et multi-dimensionnels sont supportés et peuvent
+ être créé par l'utilisateur, ou par une fonction. Il y a
+ des fonctions spécifiques qui remplissent des tableaux à partir
+ de résultats de requêtes, et de nombreuses fonctions retournent
+ un tableau.
+ </simpara>
+ <para>
+ Voir aussi
+ <function>is_array</function>,
+ <function>explode</function>,
+ <function>implode</function>,
+ <function>split</function> et
+ <function>join</function>.
+ </para>
+ </partintro>
+ <refentry id="function.array">
+ <refnamediv>
+ <refname>array</refname>
+ <refpurpose>
+ Crée un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array</function></funcdef>
+ <paramdef>mixed
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
<para>
- Voir aussi <function>is_array</function>, <function>explode</function>,
- <function>implode</function>, <function>split</function>
- et <function>join</function>.
- </para>
- </partintro>
- <refentry id="function.array">
- <refnamediv>
- <refname>array</refname>
- <refpurpose>
- Crée un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array</function></funcdef>
- <paramdef>mixed
- <parameter><optional>...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <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> 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>
- La syntaxe "index => valeur", 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>Exemple avec <function>array</function></title>
- <programlisting role="php">
+ <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> 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>
+ La syntaxe "index => valeur", 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>Exemple avec <function>array</function></title>
+ <programlisting role="php">
<?php
$fruits = array (
"fruits" => array ("a" => "orange", "b" => "banane", "c" => "pomme"),
@@ -74,22 +77,22 @@
"trous" => 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">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Index automatique d'un tableau avec <function>array</function></title>
+ <programlisting role="php">
<?php
$array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13);
print_r($array);
?>
- </programlisting>
- </example>
- qui affichera :
- <informalexample>
- <programlisting>
+ </programlisting>
+ </example>
+ qui affichera :
+ <informalexample>
+ <programlisting>
Array
(
[0] => 1
@@ -100,150 +103,152 @@
[8] => 1
[9] => 19
)
- </programlisting>
- </informalexample>
- </para>
- <para>
- 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">
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ 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 commençant à 1</title>
+ <programlisting role="php">
<?php
$firstquarter = array(1 => 'Janvier', 'Février', 'Mars');
print_r($firstquarter);
?>
- </programlisting>
- </example>
- qui affichera :
- <informalexample>
- <screen>
-Array
-(
- [1] => 'Janvier'
- [2] => 'Février'
- [3] => 'Mars'
-)
- </screen>
- </informalexample>
- </para>
- <para>
- Voir aussi : <function>list</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-count-values">
- <refnamediv>
- <refname>array_count_values</refname>
- <refpurpose>Compte le nombre de valeurs dans un tableau</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_count_values</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_count_values</function> retourne un tableau contenant
- les valeurs du tableau <parameter>input</parameter> comme clés
- et leurs fréquence comme valeur.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_count_values</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ qui affichera :
+ <informalexample>
+ <screen>
+ Array
+ (
+ [1] => 'Janvier'
+ [2] => 'Février'
+ [3] => 'Mars'
+ )
+ </screen>
+ </informalexample>
+ </para>
+ <para>
+ Voir aussi
+ <function>list</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-count-values">
+ <refnamediv>
+ <refname>array_count_values</refname>
+ <refpurpose>Compte le nombre de valeurs dans un tableau</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_count_values</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_count_values</function> retourne un tableau contenant
+ les valeurs du tableau <parameter>input</parameter> comme clés
+ et leurs fréquence comme valeur.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_count_values</function></title>
+ <programlisting role="php">
<?php
$array = array(1, "bonjour", 1, "monde", "bonjour");
array_count_values($array); // retourne array(1=>2, "bonjour"=>2, "monde"=>1)
?>
- </programlisting>
- </example>
- <note>
- <para>
- <function>array_count_values</function> a été ajoutée
- dans PHP 4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-diff">
- <refnamediv>
- <refname>array_diff</refname>
- <refpurpose>Calcule la différence entre deux tableaux</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_diff</function></funcdef>
- <paramdef>array <parameter>array1</parameter></paramdef>
- <paramdef>array <parameter>array2</parameter></paramdef>
- <paramdef>array
- <parameter><optional> ...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_diff</function> retourne un tableau
- qui contient toutes les valeurs du tableau <parameter>array1</parameter>
- qui sont absentes de tous les autres arguments.
- Notez que les clés sont préservées.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_diff</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ <note>
+ <para>
+ <function>array_count_values</function> a été ajoutée
+ dans PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-diff">
+ <refnamediv>
+ <refname>array_diff</refname>
+ <refpurpose>Calcule la différence entre deux tableaux</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_diff</function></funcdef>
+ <paramdef>array <parameter>array1</parameter></paramdef>
+ <paramdef>array <parameter>array2</parameter></paramdef>
+ <paramdef>array
+ <parameter><optional> ...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_diff</function> retourne un tableau
+ qui contient toutes les valeurs du tableau <parameter>array1</parameter>
+ qui sont absentes de tous les autres arguments.
+ Notez que les clés sont préservées.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_diff</function></title>
+ <programlisting role="php">
<?php
$array1 = array ("a" => "vert", "rouge", "bleu");
$array2 = array ("b" => "vert", "jaune", "rouge");
$result = array_diff ($array1, $array2);
?>
- </programlisting>
- </example>
- </para>
- <para>
- <varname>$result</varname> contient <literal>array("bleu");</literal>
- </para>
- <para>
- Voir aussi <function>array_intersect</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-filter">
- <refnamediv>
- <refname>array_filter</refname>
- <refpurpose>Filtre les éléments d'un tableau</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_filter</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>mixed
- <parameter><optional>callback</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_filter</function> retourne un tableau
- contenant les éléments du tableau <parameter>input</parameter>,
- filtré grâce à la fonction <parameter>callback</parameter>.
- Si <parameter>input</parameter> est un tableau associatif,
- les clés sont préservées.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_filter</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <varname>$result</varname> contient <literal>array("bleu");</literal>
+ </para>
+ <para>
+ Voir aussi
+ <function>array_intersect</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-filter">
+ <refnamediv>
+ <refname>array_filter</refname>
+ <refpurpose>Filtre les éléments d'un tableau</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_filter</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>callback</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_filter</function> retourne un tableau
+ contenant les éléments du tableau <parameter>input</parameter>,
+ filtré grâce à la fonction <parameter>callback</parameter>.
+ Si <parameter>input</parameter> est un tableau associatif,
+ les clés sont préservées.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_filter</function></title>
+ <programlisting role="php">
<?php
function pair($var) {
return ($var % 2 == 1);
@@ -256,135 +261,136 @@
$tableau_pair = array_filter($array1, "pair");
$tableau_impair = array_filter($array2, "impair");
?>
- </programlisting>
- </example>
- </para>
- <para>
- Cet exemple montre comment extraire les nombres pairs
- dans <varname>$tableau_impair</varname> : ce dernier contient
- <literal>array ("a"=>1, "c"=>3, "e"=>5);</literal>,
- et les nombres impairs dans <varname>$tableau_pair</varname> :
- ce dernier contient <literal>array (6, 8, 10, 12);</literal>,
- </para>
- <para>
- Voir aussi
- <function>array_map</function> et
- <function>array_reduce</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-flip">
- <refnamediv>
- <refname>array_flip</refname>
- <refpurpose>
- Remplace les clés par les valeurs, et les valeurs par les clés
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_flip</function></funcdef>
- <paramdef>array <parameter>trans</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_flip</function> retourne un tableau dont les clés sont les
- valeurs du précédent tableau, et les valeurs sont les clés.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_flip</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Cet exemple montre comment extraire les nombres pairs
+ dans <varname>$tableau_impair</varname> : ce dernier contient
+ <literal>array ("a"=>1, "c"=>3, "e"=>5);</literal>,
+ et les nombres impairs dans <varname>$tableau_pair</varname> :
+ ce dernier contient <literal>array (6, 8, 10, 12);</literal>,
+ </para>
+ <para>
+ Voir aussi
+ <function>array_map</function> et
+ <function>array_reduce</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-flip">
+ <refnamediv>
+ <refname>array_flip</refname>
+ <refpurpose>
+ Remplace les clés par les valeurs, et les valeurs par les clés
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_flip</function></funcdef>
+ <paramdef>array <parameter>trans</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_flip</function> retourne un tableau dont les clés sont les
+ valeurs du précédent tableau, et les valeurs sont les clés.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_flip</function></title>
+ <programlisting role="php">
<?php
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
?>
- </programlisting>
- </example>
- <note>
- <para>
- <function>array_flip</function> a été ajoutée dans PHP
4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ <note>
+ <para>
+ <function>array_flip</function> a été ajoutée dans PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.array-intersect">
- <refnamediv>
- <refname>array_intersect</refname>
- <refpurpose>Calcule l'intersection de tableaux</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_intersect</function></funcdef>
- <paramdef>array <parameter>array1</parameter></paramdef>
- <paramdef>array <parameter>array2</parameter></paramdef>
- <paramdef>array
- <parameter><optional> ...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_intersect</function> retourne un tableau
- contenant toutes les valeurs de <parameter>array1</parameter>
- qui sont présentes dans tous les autres arguments.
- Notez que les clés sont préservées.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_intersect</function></title>
- <programlisting role="php">
+ <refnamediv>
+ <refname>array_intersect</refname>
+ <refpurpose>Calcule l'intersection de tableaux</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_intersect</function></funcdef>
+ <paramdef>array <parameter>array1</parameter></paramdef>
+ <paramdef>array <parameter>array2</parameter></paramdef>
+ <paramdef>array
+ <parameter><optional> ...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_intersect</function> retourne un tableau
+ contenant toutes les valeurs de <parameter>array1</parameter>
+ qui sont présentes dans tous les autres arguments.
+ Notez que les clés sont préservées.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_intersect</function></title>
+ <programlisting role="php">
<?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" => "vert",
"rouge");</literal>.
- </para>
- <para>
- Voir aussi <function>array_diff</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-keys">
- <refnamediv>
- <refname>array_keys</refname>
- <refpurpose>Retourne toutes les clés d'un tableau</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_keys</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>mixed
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <varname>$result</varname> contient <literal>array ("a" => "vert",
+"rouge");</literal>.
+ </para>
+ <para>
+ Voir aussi
+ <function>array_diff</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-keys">
+ <refnamediv>
+ <refname>array_keys</refname>
+ <refpurpose>Retourne toutes les clés d'un tableau</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_keys</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>mixed
<parameter>
- <optional>search_value</optional>
+ <optional>search_value</optional>
</parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <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,
- seules les clés ayant cette valeur seront retournées.
- Sinon, toutes les clés de <parameter>input</parameter> sont
- retournées.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_keys</function></title>
- <programlisting role="php">
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <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,
+ seules les clés ayant cette valeur seront retournées.
+ Sinon, toutes les clés de <parameter>input</parameter> sont
+ retournées.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_keys</function></title>
+ <programlisting role="php">
<?php
$array = array(0 => 100, "couleur" => "rouge");
array_keys($array);
@@ -397,19 +403,19 @@
array_keys($array);
// retourne array("couleur", "taille")
?>
- </programlisting>
- </example>
- </para>
- <note>
- <para>
- <function>array_keys</function> a été ajoutée dans PHP 4.
- Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3:
- <example>
- <title>
- Implémentation de <function>array_keys</function> pour
- les utilisateurs de PHP 3
- </title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <note>
+ <para>
+ <function>array_keys</function> a été ajoutée dans PHP 4.
+ Ci-dessous, voici une implémentation qui fonctionnera sous PHP 3:
+ <example>
+ <title>
+ Implémentation de <function>array_keys</function> pour
+ les utilisateurs de PHP 3
+ </title>
+ <programlisting role="php">
<?php
function array_keys ($arr, $term="") {
$t = array();
@@ -421,66 +427,66 @@
return $t;
}
?>
- </programlisting>
- </example>
- </para>
- </note>
- <para>
- Voir aussi
- <function>array_values</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-map">
- <refnamediv>
- <refname>array_map</refname>
- <refpurpose>Applique sur fonction sur des tableaux</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_map</function></funcdef>
- <paramdef>mixed <parameter>callback</parameter></paramdef>
- <paramdef>array <parameter>arr1</parameter></paramdef>
- <paramdef>array
- <parameter><optional>arr2...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_map</function> retourne un tableau
- contenant tous les éléments du tableau <parameter>arr1</parameter>,
- après leur avoir appliqué la fonction
<parameter>callback</parameter>.
- Le nombre de paramètre de la fonction <parameter>callback</parameter>
- doit être égal au nombre de tableaux passés dans la fonction
- <function>array_map</function>.
+ </programlisting>
+ </example>
</para>
- <para>
- <example>
- <title>Exemple avec <function>array_map</function></title>
- <programlisting role="php">
+ </note>
+ <para>
+ Voir aussi
+ <function>array_values</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-map">
+ <refnamediv>
+ <refname>array_map</refname>
+ <refpurpose>Applique sur fonction sur des tableaux</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_map</function></funcdef>
+ <paramdef>mixed <parameter>callback</parameter></paramdef>
+ <paramdef>array <parameter>arr1</parameter></paramdef>
+ <paramdef>array
+ <parameter><optional>arr2...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_map</function> retourne un tableau
+ contenant tous les éléments du tableau <parameter>arr1</parameter>,
+ après leur avoir appliqué la fonction
+<parameter>callback</parameter>.
+ Le nombre de paramètre de la fonction <parameter>callback</parameter>
+ doit être égal au nombre de tableaux passés dans la fonction
+ <function>array_map</function>.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_map</function></title>
+ <programlisting role="php">
<?php
function cube($n) {
- return $n*$n*$n;
+ return $n*$n*$n;
}
$a = array(1, 2, 3, 4, 5);
$b = array_map("cube", $a);
?>
- </programlisting>
- </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_filter</function> - utilisation de plusieurs
tableaux</title>
- <programlisting role="php">
+ </programlisting>
+ </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_filter</function> - utilisation de plusieurs
+tableaux</title>
+ <programlisting role="php">
<?php
function parle_espagnol($n, $m) {
- return "Le nombre $n se dit $m en espagnol";
+ return "Le nombre $n se dit $m en espagnol";
}
function map_espagnol($n, $m) {
return array($n => $m);
@@ -530,23 +536,23 @@
//
// )
?>
- </programlisting>
- </example>
- </para>
- <para>
- Généralement, lorsque vous utilisez plusieurs tableaux, ils doivent
- être de même longueur, car la fonction de callback est
appliqué à
- un élément de chaque tableau. Si les tableaux sont de taille
inégale,
- les plus courts seront remplis d'éléments vides.
- </para>
- <para>
- Une utilisation interessante de cette fonction est de construire des
- tableaux de tableaux, grâce à la fonction de callback
<literal>null</literal>.
- </para>
- <para>
- <example>
- <title><function>array_map</function> - création d'un tableau de
tableaux</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Généralement, lorsque vous utilisez plusieurs tableaux, ils doivent
+ être de même longueur, car la fonction de callback est
+appliqué à
+ un élément de chaque tableau. Si les tableaux sont de taille
+inégale,
+ les plus courts seront remplis d'éléments vides.
+ </para>
+ <para>
+ Une utilisation interessante de cette fonction est de construire des
+ tableaux de tableaux, grâce à la fonction de callback
+<literal>null</literal>.
+ </para>
+ <para>
+ <example>
+ <title><function>array_map</function> - création d'un tableau de
+tableaux</title>
+ <programlisting role="php">
<?php
$a = array(1, 2, 3, 4, 5);
$b = array("un", "deux", "trois", "quatre", "cinq");
@@ -593,272 +599,273 @@
//
// )
?gt;
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi
- <function>array_filter</function> et
- <function>array_reduce</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-merge">
- <refnamediv>
- <refname>array_merge</refname>
- <refpurpose>Rassemble plusieurs tableaux</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_merge</function></funcdef>
- <paramdef>array <parameter>array1</parameter></paramdef>
- <paramdef>array <parameter>array2</parameter></paramdef>
- <paramdef>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>array_filter</function> et
+ <function>array_reduce</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-merge">
+ <refnamediv>
+ <refname>array_merge</refname>
+ <refpurpose>Rassemble plusieurs tableaux</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_merge</function></funcdef>
+ <paramdef>array <parameter>array1</parameter></paramdef>
+ <paramdef>array <parameter>array2</parameter></paramdef>
+ <paramdef>
<parameter><optional> ...</optional></parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_merge</function> rassemble les éléments de
- plusieurs tableaux ensemble, en ajoutant les valeurs de l'un à la
- fin de l'autre. Le résultat est un tableau.
- </para>
- <para>
- Si les tableaux ont des clés en commun, la dernière valeur
- rencontrée écrasera l'ancienne. Pour les valeurs
numériques,
- cela n'arrive pas, car alors, les valeurs sont ajoutées en fin de
- tableau.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_merge</function></title>
- <programlisting role="php">
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_merge</function> rassemble les éléments de
+ plusieurs tableaux ensemble, en ajoutant les valeurs de l'un à la
+ fin de l'autre. Le résultat est un tableau.
+ </para>
+ <para>
+ Si les tableaux ont des clés en commun, la dernière valeur
+ rencontrée écrasera l'ancienne. Pour les valeurs numériques,
+ cela n'arrive pas, car alors, les valeurs sont ajoutées en fin de
+ tableau.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_merge</function></title>
+ <programlisting role="php">
<?php
$array1 = array ("couleur" => "rouge", 2, 4);
$array2 = array ("a", "b", "couleur" => "vert", "forme" =>
"trapézoïde");
array_merge ($array1, $array2);
?>
- </programlisting>
- <para>
- Le résultat sera array("couleur" => "vert", 2, 4, "a",
- "b", "forme" => "trapézoîde").
- </para>
- </example>
- <note>
- <para>
- <function>array_merge</function> a été ajoutée dans
- PHP 4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ <para>
+ Le résultat sera array("couleur" => "vert", 2, 4, "a",
+ "b", "forme" => "trapézoîde").
+ </para>
+ </example>
+ <note>
+ <para>
+ <function>array_merge</function> a été ajoutée dans
+ PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.array-merge-recursive">
- <refnamediv>
- <refname>array_merge_recursive</refname>
- <refpurpose>Combine plusieurs tableaux ensemble, récursivement</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_merge_recursive</function></funcdef>
- <paramdef>array <parameter>array1</parameter></paramdef>
- <paramdef>array <parameter>array2</parameter></paramdef>
- <paramdef>array
- <parameter><optional>...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_merge_recursive</function> rassemble tous les
- éléments de plusieurs tableaux ensemble, en ajoutant les
- éléments de l'un à la suite des
- éléménts du précédent.
- <function>array_merge_recursive</function> retourne le tableau
- résultant.
- </para>
- <para>
- Si les tableaux passés en arguments ont les mêmes clés
- (chaînes de caractères), les valeurs sont alors
- rassemblées dans un tableau, de manière récursive,
- de façon à ce que, si l'une de ces valeurs est un tableau
- elle-même, la fonction la rassemblera avec les valeurs de
- l'entrée courante. Cependant, si deux tableaux ont la même
- clé numérique, la dernière valeur n'écrasera
- pas la précédente, mais sera ajouté à la fin
- du tableau.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_merge_recursive</function></title>
- <programlisting role="php">
+ <refnamediv>
+ <refname>array_merge_recursive</refname>
+ <refpurpose>Combine plusieurs tableaux ensemble, récursivement</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_merge_recursive</function></funcdef>
+ <paramdef>array <parameter>array1</parameter></paramdef>
+ <paramdef>array <parameter>array2</parameter></paramdef>
+ <paramdef>array
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_merge_recursive</function> rassemble tous les
+ éléments de plusieurs tableaux ensemble, en ajoutant les
+ éléments de l'un à la suite des
+ éléménts du précédent.
+ <function>array_merge_recursive</function> retourne le tableau
+ résultant.
+ </para>
+ <para>
+ Si les tableaux passés en arguments ont les mêmes clés
+ (chaînes de caractères), les valeurs sont alors
+ rassemblées dans un tableau, de manière récursive,
+ de façon à ce que, si l'une de ces valeurs est un tableau
+ elle-même, la fonction la rassemblera avec les valeurs de
+ l'entrée courante. Cependant, si deux tableaux ont la même
+ clé numérique, la dernière valeur n'écrasera
+ pas la précédente, mais sera ajouté à la fin
+ du tableau.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_merge_recursive</function></title>
+ <programlisting role="php">
<?php
$ar1 = array ("couleur" => array ("favorie" ?> "rouge"), 5);
$ar2 = array (10, "couleur" ?> array ("favorie" ?> "vert", "rouge"));
$result = array_merge_recursive ($ar1, $ar2);
?>
- </programlisting>
- </example>
- </para>
- <para>
- Le résultat sera
- <literal>array("couleur" => array("favorie" => array ("rouge", "vert"),
"bleu"), 5, 10)</literal>.
- </para>
- <para>
- Voir aussi <function>array_merge</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-multisort">
- <refnamediv>
- <refname>array_multisort</refname>
- <refpurpose>Tri multi-dimensionnel</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>array_multisort</function></funcdef>
- <paramdef>array <parameter>ar1</parameter></paramdef>
- <paramdef>mixed
- <parameter><optional>arg</optional></parameter>
- </paramdef>
- <paramdef>mixed
- <parameter><optional>...</optional></parameter>
- </paramdef>
- <paramdef>array
- <parameter><optional>...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_multisort</function> sert à trier simultanément
- plusieurs tableaux, ou bien à trier un tableau multi-dimensionnel,
- suivant l'une ou l'autre de ses dimensions. Les clés sont
- préservées.
- </para>
- <para>
- Les tableaux passés en arguments sont traités comme les colonnes
- d'une table, triées par lignes (un peu comme la clause SQL ORDER BY).
- Le premier tableau est la clé primaire de tri. Les valeurs du premier
- tableaux qui sont égales, sont triées grâce au tableau
suivant,
- et ainsi de suite...
- </para>
- <para>
- La structure des arguments de <function>array_multisort</function> 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 deux options de tri, prises dans les valeurs suivantes :
- </para>
- <para>
- Options de tri :
- <itemizedlist>
- <listitem>
- <simpara>SORT_ASC - Tri en ordre ascendant</simpara>
- </listitem>
- <listitem>
- <simpara>SORT_DESC - Tri en ordre descendant</simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- Options de type de tri:
- <itemizedlist>
- <listitem>
- <simpara>SORT_REGULAR - Comparaison normale des valeurs</simpara>
- </listitem>
- <listitem>
- <simpara>SORT_NUMERIC - Comparaison numérique des valeurs</simpara>
- </listitem>
- <listitem>
- <simpara>SORT_STRING - Comparaison alphabétique des valeurs</simpara>
- </listitem>
- </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
- à SORT_ASC et SORT_REGULAR.
- </para>
- <para>
- Retourne <literal>TRUE</literal> en cas de succès,
<literal>FALSE</literal> sinon.
- </para>
- <para>
- <example>
- <title>Trier plusieurs tableaux</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Le résultat sera
+ <literal>array("couleur" => array("favorie" => array ("rouge", "vert"),
+"bleu"), 5, 10)</literal>.
+ </para>
+ <para>
+ Voir aussi
+ <function>array_merge</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-multisort">
+ <refnamediv>
+ <refname>array_multisort</refname>
+ <refpurpose>Tri multi-dimensionnel</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>array_multisort</function></funcdef>
+ <paramdef>array <parameter>ar1</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>arg</optional></parameter>
+ </paramdef>
+ <paramdef>mixed
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ <paramdef>array
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_multisort</function> sert à trier simultanément
+ plusieurs tableaux, ou bien à trier un tableau multi-dimensionnel,
+ suivant l'une ou l'autre de ses dimensions. Les clés sont
+ préservées.
+ </para>
+ <para>
+ Les tableaux passés en arguments sont traités comme les colonnes
+ d'une table, triées par lignes (un peu comme la clause SQL ORDER BY).
+ Le premier tableau est la clé primaire de tri. Les valeurs du premier
+ tableaux qui sont égales, sont triées grâce au tableau
+suivant,
+ et ainsi de suite...
+ </para>
+ <para>
+ La structure des arguments de <function>array_multisort</function> 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 deux options de tri, prises dans les valeurs suivantes :
+ </para>
+ <para>
+ Options de tri :
+ <itemizedlist>
+ <listitem>
+ <simpara>SORT_ASC - Tri en ordre ascendant</simpara>
+ </listitem>
+ <listitem>
+ <simpara>SORT_DESC - Tri en ordre descendant</simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Options de type de tri:
+ <itemizedlist>
+ <listitem>
+ <simpara>SORT_REGULAR - Comparaison normale des valeurs</simpara>
+ </listitem>
+ <listitem>
+ <simpara>SORT_NUMERIC - Comparaison numérique des valeurs</simpara>
+ </listitem>
+ <listitem>
+ <simpara>SORT_STRING - Comparaison alphabétique des valeurs</simpara>
+ </listitem>
+ </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
+ à SORT_ASC et SORT_REGULAR.
+ </para>
+ <para>
+ Retourne <literal>TRUE</literal> en cas de succès,
+<literal>FALSE</literal> sinon.
+ </para>
+ <para>
+ <example>
+ <title>Trier plusieurs tableaux</title>
+ <programlisting role="php">
<?php
$ar1 = array ("10", 100, 100, "a");
$ar2 = array (1, 3, "2", 1);
array_multisort ($ar1, $ar2);
?>
- </programlisting>
- </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
- correspondent aux valeurs jumelles du premier
- tableau (100 et 100), sont aussi triées.
- </para>
- <para>
- <example>
- <title>Classer un tableau multidimensionnel</title>
- <programlisting role="php">
+ </programlisting>
+ </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
+ correspondent aux valeurs jumelles du premier
+ tableau (100 et 100), sont aussi triées.
+ </para>
+ <para>
+ <example>
+ <title>Classer un tableau multidimensionnel</title>
+ <programlisting role="php">
<?php
$ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1));
array_multisort ($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
?>
- </programlisting>
- </example>
- </para>
- <para>
+ </programlisting>
+ </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
numérique, ordre décroissant).
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-pad">
- <refnamediv>
- <refname>array_pad</refname>
- <refpurpose>
- Complète un tableau jusqu'à la longueur spécifiée,
- avec une valeur.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_pad</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>int <parameter>pad_size</parameter></paramdef>
- <paramdef>mixed <parameter>pad_value</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_pad</function> retourne une copie du tableau
- <parameter>input</parameter> complété jusqu'à la taille de
- <parameter>pad_size</parameter> avec la valeur
- <parameter>pad_value</parameter>. si <parameter>pad_size</parameter> est positif
- alors le tableau est complété à droite, si il est
- négatif, il est complété à gauche. Si la valeur
- absolue de <parameter>pad_size</parameter> est plus petite que la taille du
- tableau <parameter>input</parameter> alors le tableau n'est pas
- complété.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_pad</function></title>
- <programlisting role="php">
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-pad">
+ <refnamediv>
+ <refname>array_pad</refname>
+ <refpurpose>
+ Complète un tableau jusqu'à la longueur spécifiée,
+ avec une valeur.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_pad</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>int <parameter>pad_size</parameter></paramdef>
+ <paramdef>mixed <parameter>pad_value</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_pad</function> retourne une copie du tableau
+ <parameter>input</parameter> complété jusqu'à la taille de
+ <parameter>pad_size</parameter> avec la valeur
+ <parameter>pad_value</parameter>. si <parameter>pad_size</parameter> est positif
+ alors le tableau est complété à droite, si il est
+ négatif, il est complété à gauche. Si la valeur
+ absolue de <parameter>pad_size</parameter> est plus petite que la taille du
+ tableau <parameter>input</parameter> alors le tableau n'est pas
+ complété.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_pad</function></title>
+ <programlisting role="php">
<?php
$input = array (12, 10, 9);
$result = array_pad ($input, 5, 0);
@@ -868,213 +875,214 @@
$result = array_pad ($input, 2, "noop");
// pas complété
?>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-pop">
- <refnamediv>
- <refname>array_pop</refname>
- <refpurpose>
- Dépile un élément de la fin d'un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>array_pop</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_pop</function> dépile et retourne le dernier
- élément du tableau <parameter>array</parameter>, le
- raccourcissant d'un élément. Si <parameter>array</parameter>
- est vide, ou n'est pas un tableau, <function>array_pop</function>
- retourne <varname>NULL</varname>.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_pop</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-pop">
+ <refnamediv>
+ <refname>array_pop</refname>
+ <refpurpose>
+ Dépile un élément de la fin d'un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_pop</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_pop</function> dépile et retourne le dernier
+ élément du tableau <parameter>array</parameter>, le
+ raccourcissant d'un élément. Si <parameter>array</parameter>
+ est vide, ou n'est pas un tableau, <function>array_pop</function>
+ retourne <varname>NULL</varname>.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_pop</function></title>
+ <programlisting role="php">
<?php
$stack = array ("orange", "pomme", "framboise");
$fruit = array_pop ($stack);
?>
- </programlisting>
- <para>
-Après ceci, $stack n'a plus que 2 éléments: "orange" et "pomme",
- tandis que $fruit contient "framboise".
- </para>
- </example>
- </para>
- <para>
- Voir aussi
- <function>array_push</function>,
- <function>array_shift</function> et
- <function>array_unshift</function>.
- <note>
- <para>
- <function>array_pop</function> a été ajoutée dans PHP 4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-push">
- <refnamediv>
- <refname>array_push</refname>
- <refpurpose>
- Empile un ou plusieurs éléments à la fin d'un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>array_push</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>mixed <parameter>var</parameter></paramdef>
- <paramdef>
+ </programlisting>
+ <para>
+ Après ceci, $stack n'a plus que 2 éléments: "orange" et
+"pomme",
+ tandis que $fruit contient "framboise".
+ </para>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>array_push</function>,
+ <function>array_shift</function> et
+ <function>array_unshift</function>.
+ <note>
+ <para>
+ <function>array_pop</function> a été ajoutée dans PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-push">
+ <refnamediv>
+ <refname>array_push</refname>
+ <refpurpose>
+ Empile un ou plusieurs éléments à la fin d'un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>array_push</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>mixed <parameter>var</parameter></paramdef>
+ <paramdef>
<parameter><optional>...</optional></parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_push</function> considère <parameter>array</parameter>
- comme une pile, et empile les variables passées en paramètres
- à la fin de <parameter>array</parameter>.
- La longueur du tableau <parameter>array</parameter> augmente d'autant.
- Cela a le même effet que :
- <programlisting role="php">
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_push</function> considère <parameter>array</parameter>
+ comme une pile, et empile les variables passées en paramètres
+ à la fin de <parameter>array</parameter>.
+ La longueur du tableau <parameter>array</parameter> augmente d'autant.
+ Cela a le même effet que :
+ <programlisting role="php">
<?php
$array[] = $var;
?>
- </programlisting>
- repeté pour chaque <parameter>var</parameter>.
- </para>
- <para>
- Retourne le nouveau nombre d'éléments du tableau.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_push</function></title>
- <programlisting role="php">
+ </programlisting>
+ repeté pour chaque <parameter>var</parameter>.
+ </para>
+ <para>
+ Retourne le nouveau nombre d'éléments du tableau.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_push</function></title>
+ <programlisting role="php">
<?php
$stack = array (1, 2);
array_push($stack, "+", 3);
?>
- </programlisting>
- </example>
- Cet exemple fait que $stack a 4 éléments: 1, 2, "+",
- et 3.
- </para>
- <para>
- Voir aussi
- <function>array_pop</function>,
- <function>array_shift</function> et
- <function>array_unshift</function>.
- <note>
- <para>
- <function>array_push</function> a été ajoutée dans PHP
4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-reverse">
- <refnamediv>
- <refname>array_reverse</refname>
- <refpurpose>
- Retourne un tableau dont les éléments sont classés en sens
- inverse.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_reverse</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>bool
- <parameter><optional>preserve_keys</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_reverse</function> prend le tableau <parameter>array</parameter>
- et retourne un nouveau tableau qui contient les mêmes
éléments
- mais dans l'ordre inverse, en préservant les clés si le
paramètre
- <parameter>preserve_keys</parameter> vaut <literal>TRUE</literal>.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_reverse</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ Cet exemple fait que $stack a 4 éléments: 1, 2, "+",
+ et 3.
+ </para>
+ <para>
+ Voir aussi
+ <function>array_pop</function>,
+ <function>array_shift</function> et
+ <function>array_unshift</function>.
+ <note>
+ <para>
+ <function>array_push</function> a été ajoutée dans PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-reverse">
+ <refnamediv>
+ <refname>array_reverse</refname>
+ <refpurpose>
+ Retourne un tableau dont les éléments sont classés en sens
+ inverse.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_reverse</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>bool
+ <parameter><optional>preserve_keys</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_reverse</function> prend le tableau <parameter>array</parameter>
+ et retourne un nouveau tableau qui contient les mêmes éléments
+ mais dans l'ordre inverse, en préservant les clés si le
+paramètre
+ <parameter>preserve_keys</parameter> vaut <literal>TRUE</literal>.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_reverse</function></title>
+ <programlisting role="php">
<?php
$input = array ("php", 4.0, array ("rouge", "vert"));
$result = array_reverse ($input, TRUE);
?>
- </programlisting>
- </example>
- Au final, $result contient (array ("rouge", "vert"), 4.0, "php"). Mais
- <varname>$result2[0]</varname> vaut toujours <literal>"php"</literal>.
- <note>
- <para>
- <function>array_reverse</function> a été ajoutée en
- PHP 4.0 Beta 3.
- </para>
- </note>
+ </programlisting>
+ </example>
+ Au final, $result contient (array ("rouge", "vert"), 4.0, "php"). Mais
+ <varname>$result2[0]</varname> vaut toujours <literal>"php"</literal>.
<note>
<para>
- Le second paramètre <parameter>preserve_keys</parameter> a
été éjouté en PHP 4.0.3.
+ <function>array_reverse</function> a été ajoutée en
+ PHP 4.0 Beta 3.
</para>
</note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-reduce">
- <refnamediv>
- <refname>array_reduce</refname>
- <refpurpose>
- Réduit itérativement un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>array_reduce</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>mixed <parameter>callback</parameter></paramdef>
- <paramdef>int
- <parameter><optional>initial</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_reduce</function> applique itérativement
- la fonction <parameter>callback</parameter> aux éléments du
- tableau <parameter>input</parameter>, de manière à réduire
le
- tableau à une valeur simple. Si l'argument optionnel
- <parameter>intial</parameter> est disponible, il sera utilisé pour
- initialiser le processus, ou bien comme valeur finale si le
- tableau est vide.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_reduce</function></title>
- <programlisting role="php">
+ <note>
+ <para>
+ Le second paramètre <parameter>preserve_keys</parameter> a
+été
+ ajouté en PHP 4.0.3.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-reduce">
+ <refnamediv>
+ <refname>array_reduce</refname>
+ <refpurpose>
+ Réduit itérativement un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_reduce</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>mixed <parameter>callback</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>initial</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_reduce</function> applique itérativement
+ la fonction <parameter>callback</parameter> aux éléments du
+ tableau <parameter>input</parameter>, de manière à réduire le
+ tableau à une valeur simple. Si l'argument optionnel
+ <parameter>intial</parameter> est disponible, il sera utilisé pour
+ initialiser le processus, ou bien comme valeur finale si le
+ tableau est vide.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_reduce</function></title>
+ <programlisting role="php">
<?php
function rsum($v, $w) {
- $v += $w;
- return $v;
+ $v += $w;
+ return $v;
}
function rmul($v, $w) {
- $v *= $w;
- return $v;
+ $v *= $w;
+ return $v;
}
$a = array(1, 2, 3, 4, 5);
$x = array();
@@ -1082,60 +1090,60 @@
$c = array_reduce($a, "rmul", 10);
$d = array_reduce($x, "rsum", 1);
?>
- </programlisting>
- </example>
- </para>
- <para>
- Dans cet exemple, <varname>$b</varname> contiendra <literal>15</literal>,
- <varname>$c</varname> contiendra <literal>1200</literal> (= 1*2*3*4*5*10),
- et <varname>$d</varname> contiendra <literal>1</literal>.
- </para>
- <para>
- Voir aussi
- <function>array_filter</function> et
- <function>array_map</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-rand">
- <refnamediv>
- <refname>array_rand</refname>
- <refpurpose>
- Prend une ou plusieurs valeurs, au hasard dans un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>array_rand</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>int
- <parameter><optional>num_req</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_rand</function> est pratique lorsque vous voulez
- selectionner une ou plusieurs valeurs au hasard dans un tableau.
- Le paramètre <parameter>input</parameter> est un tableau, et
- <parameter>num_req</parameter> spéficie le nombre de valeurs que
- vous voulez obtenir (par défaut, c'est 1).
- </para>
- <para>
- Si vous ne demandez qu'une entrée, <function>array_rand</function>
- retourne l'index de la valeur. Sinon, elle retourne un tableau
- d'index. Cela vous permet de faire une selection au hasard de clés,
- ou bien de valeur.
- </para>
- <para>
- N'oubliez pas d'appeler <function>srand</function> pour initialiser le
- générateur de nombres aléatoires.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_rand</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Dans cet exemple, <varname>$b</varname> contiendra <literal>15</literal>,
+ <varname>$c</varname> contiendra <literal>1200</literal> (= 1*2*3*4*5*10),
+ et <varname>$d</varname> contiendra <literal>1</literal>.
+ </para>
+ <para>
+ Voir aussi
+ <function>array_filter</function> et
+ <function>array_map</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-rand">
+ <refnamediv>
+ <refname>array_rand</refname>
+ <refpurpose>
+ Prend une ou plusieurs valeurs, au hasard dans un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_rand</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>num_req</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_rand</function> est pratique lorsque vous voulez
+ selectionner une ou plusieurs valeurs au hasard dans un tableau.
+ Le paramètre <parameter>input</parameter> est un tableau, et
+ <parameter>num_req</parameter> spéficie le nombre de valeurs que
+ vous voulez obtenir (par défaut, c'est 1).
+ </para>
+ <para>
+ Si vous ne demandez qu'une entrée, <function>array_rand</function>
+ retourne l'index de la valeur. Sinon, elle retourne un tableau
+ d'index. Cela vous permet de faire une selection au hasard de clés,
+ ou bien de valeur.
+ </para>
+ <para>
+ N'oubliez pas d'appeler <function>srand</function> pour initialiser le
+ générateur de nombres aléatoires.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_rand</function></title>
+ <programlisting role="php">
<?php
srand ((double) microtime() * 10000000);
$input = array ("Neo", "Morpheus", "Trinitée", "Cypher", "Tank");
@@ -1143,105 +1151,106 @@
print $input[$rand_keys[0]]."\n";
print $input[$rand_keys[1]]."\n";
?>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-shift">
- <refnamediv>
- <refname>array_shift</refname>
- <refpurpose>
- Dépile un élément au début d'un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>array_shift</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </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.
- Si <parameter>array</parameter> est vide, ou n'est pas un tableau,
- <function>array_shift</function> retourne <varname>NULL</varname>.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_shift</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-shift">
+ <refnamediv>
+ <refname>array_shift</refname>
+ <refpurpose>
+ Dépile un élément au début d'un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_shift</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </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.
+ Si <parameter>array</parameter> est vide, ou n'est pas un tableau,
+ <function>array_shift</function> retourne <varname>NULL</varname>.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_shift</function></title>
+ <programlisting role="php">
<?php
$args = array ("-v", "-f");
$opt = array_shift ($args);
?>
- </programlisting>
- </example>
- Cet exemple aura pour ré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 été ajoutée dans PHP
4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-slice">
- <refnamediv>
- <refname>array_slice</refname>
- <refpurpose>Extrait une portion de tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_slice</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>int <parameter>offset</parameter></paramdef>
- <paramdef>int
+ </programlisting>
+ </example>
+ Cet exemple aura pour ré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 été ajoutée dans PHP
+4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-slice">
+ <refnamediv>
+ <refname>array_slice</refname>
+ <refpurpose>Extrait une portion de tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_slice</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>int <parameter>offset</parameter></paramdef>
+ <paramdef>int
<parameter>
- <optional>length</optional>
+ <optional>length</optional>
</parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_slice</function> retourne une série d'
- élément du tableau <parameter>array</parameter> commencant à
- l'offset <parameter>offset</parameter> et représentant
- <parameter>length</parameter> éléments.
- </para>
- <para>
- Si <parameter>offset</parameter> est positif, la série commencera
- à cet offset dans le tableau <parameter>array</parameter>. Si
- <parameter>offset</parameter> est négatif, cette série
- commencera à l'offset offset mais en commencant à la
- fin du tableau <parameter>array</parameter>.
- </para>
- <para>
- Si <parameter>length</parameter> est fourni et positif, alors la
- série retournée aura autant d'éléments.
- Si <parameter>length</parameter> est fourni et négatif, alors la
- série contiendra les éléments depuis l'offset
- <parameter>offset</parameter> jusqu'à <parameter>length</parameter>
- éléments en partant de la fin. Si
- <parameter>length</parameter> est omis, la séquence lira tous les
- éléments du tableau, depuis l'<parameter>offset</parameter>
- précisé jusqu'à la fin du tableau.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_slice</function></title>
- <programlisting role="php">
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_slice</function> retourne une série d'
+ élément du tableau <parameter>array</parameter> commençant
+à
+ l'offset <parameter>offset</parameter> et représentant
+ <parameter>length</parameter> éléments.
+ </para>
+ <para>
+ Si <parameter>offset</parameter> est positif, la série commencera
+ à cet offset dans le tableau <parameter>array</parameter>. Si
+ <parameter>offset</parameter> est négatif, cette série
+ commencera à l'offset offset mais en commençant à la
+ fin du tableau <parameter>array</parameter>.
+ </para>
+ <para>
+ Si <parameter>length</parameter> est fourni et positif, alors la
+ série retournée aura autant d'éléments.
+ Si <parameter>length</parameter> est fourni et négatif, alors la
+ série contiendra les éléments depuis l'offset
+ <parameter>offset</parameter> jusqu'à <parameter>length</parameter>
+ éléments en partant de la fin. Si
+ <parameter>length</parameter> est omis, la séquence lira tous les
+ éléments du tableau, depuis l'<parameter>offset</parameter>
+ précisé jusqu'à la fin du tableau.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_slice</function></title>
+ <programlisting role="php">
<?php
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2); // retourne "c", "d", et "e"
@@ -1250,63 +1259,64 @@
$output = array_slice($input, 2, -1); // retourne "c", "d"
// Equivalent à :
$offset = 2; $length = -1;
-$output = array_slice($input, 2, count($input) - $offset + $length);
+$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"
?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi <function>array_splice</function>.
- <note>
- <para>
- <function>array_slice</function> a été ajoutée dans PHP
4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-splice">
- <refnamediv>
- <refname>array_splice</refname>
- <refpurpose>
- Efface et remplace une portion de tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_splice</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>int <parameter>offset</parameter></paramdef>
- <paramdef>int
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>array_splice</function>.
+ <note>
+ <para>
+ <function>array_slice</function> a été ajoutée dans PHP
+4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-splice">
+ <refnamediv>
+ <refname>array_splice</refname>
+ <refpurpose>
+ Efface et remplace une portion de tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_splice</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>int <parameter>offset</parameter></paramdef>
+ <paramdef>int
<parameter><optional>length</optional></parameter>
</paramdef>
- <paramdef>array
+ <paramdef>array
<parameter>
- <optional>replacement</optional>
+ <optional>replacement</optional>
</parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_splice</function> supprime les éléments
- désignés par <parameter>offset</parameter> et
- <parameter>length</parameter> du tableau <parameter>input</parameter> et
- les remplace par les éléments du tableau
- <parameter>replacement</parameter>, si ce dernier est présent.
- </para>
- <para>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_splice</function> supprime les éléments
+ désignés par <parameter>offset</parameter> et
+ <parameter>length</parameter> du tableau <parameter>input</parameter> et
+ les remplace par les éléments du tableau
+ <parameter>replacement</parameter>, si ce dernier est présent.
+ </para>
+ <para>
Si <parameter>offset</parameter> est positif, la série commencera
à cet offset dans le tableau <parameter>input</parameter>.
Si <parameter>offset</parameter> est négatif, cette série
- commencera à l'offset <parameter>offset</parameter> mais en commencant
+ commencera à l'offset <parameter>offset</parameter> mais en
+commençant
à la fin du tableau <parameter>input</parameter>.
- </para>
- <para>
+ </para>
+ <para>
Si <parameter>length</parameter> est donné et positif, alors la
série aura autant d'éléments. Si
<parameter>length</parameter>
est donné et négatif, les éléments seront pris
@@ -1318,24 +1328,24 @@
<parameter>offset</parameter> jusqu'à la fin, même si un tableau
de remplacement replacement est spécifié, utilisez
count(<literal>count($input)</literal>) à la place de length.
- </para>
- <para>
- Si <parameter>replacement</parameter> est précisé, alors les
- éléments supprimés sont remplacés par les
- éléments de ce tableau. Si l'<parameter>offset</parameter>
- et <parameter>length</parameter> sont tels que la taille du tableau ne change
pas,
- alors les éléments du tableau de remplacement replacement sont
- insérés à partir de l'offset <parameter>offset</parameter>.
- </para>
- <para>
- Conseil : si le tableau de remplacement ne contient qu'un seul
- élément, il n'est pas obligatoire de forcer le type en
- tableau avec <function>array</function>, à moins que cette variable ne
soit
- elle même un tableau.
- </para>
- <para>
- Les codes suivants sont équivalents :
- <programlisting role="php">
+ </para>
+ <para>
+ Si <parameter>replacement</parameter> est précisé, alors les
+ éléments supprimés sont remplacés par les
+ éléments de ce tableau. Si l'<parameter>offset</parameter>
+ et <parameter>length</parameter> sont tels que la taille du tableau ne change pas,
+ alors les éléments du tableau de remplacement replacement sont
+ insérés à partir de l'offset <parameter>offset</parameter>.
+ </para>
+ <para>
+ Conseil : si le tableau de remplacement ne contient qu'un seul
+ élément, il n'est pas obligatoire de forcer le type en
+ tableau avec <function>array</function>, à moins que cette variable ne soit
+ elle même un tableau.
+ </para>
+ <para>
+ Les codes suivants sont équivalents :
+ <programlisting role="php">
<?php
array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y))
array_pop($input) array_splice($input, -1)
@@ -1343,16 +1353,16 @@
array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y))
$a[$x] = $y array_splice($input, $x, 1, $y)
?>
- </programlisting>
- </para>
- <para>
- <function>array_splice</function> retourne le tableau des éléments
- supprimés.
- </para>
- <para>
- <example>
- <title>Exemples avec <function>array_splice</function></title>
- <programlisting role="php">
+ </programlisting>
+ </para>
+ <para>
+ <function>array_splice</function> retourne le tableau des éléments
+ supprimés.
+ </para>
+ <para>
+ <example>
+ <title>Exemples avec <function>array_splice</function></title>
+ <programlisting role="php">
<?php
$input = array("rouge", "vert", "bleu", "jaune");
array_splice($input, 2); // $input est array("rouge", "vert")
@@ -1363,44 +1373,45 @@
// $input est array("rouge", "vert",
// "bleu", "noir", "marron")
?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi <function>array_slice</function>.
- <note>
- <para>
- <function>array_splice</function> a été ajoutée
- dans PHP 4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-sum">
- <refnamediv>
- <refname>array_sum</refname>
- <refpurpose>
- Calcule la somme des valeurs du tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>array_sum</function></funcdef>
- <paramdef>array <parameter>arr</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_sum</function> retourne la somme des
- valeurs du tableau, sous forme d'un entier ou d'un
- nombre à virgule flottante.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_sum</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>array_slice</function>.
+ <note>
+ <para>
+ <function>array_splice</function> a été ajoutée
+ dans PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-sum">
+ <refnamediv>
+ <refname>array_sum</refname>
+ <refpurpose>
+ Calcule la somme des valeurs du tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_sum</function></funcdef>
+ <paramdef>array <parameter>arr</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_sum</function> retourne la somme des
+ valeurs du tableau, sous forme d'un entier ou d'un
+ nombre à virgule flottante.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_sum</function></title>
+ <programlisting role="php">
<?php
$a = array(2,4,6,8);
echo "somme(a) = ".array_sum($a)."\n";
@@ -1409,140 +1420,141 @@
echo "somme(b) = ".array_sum($b)."\n";
// affiche : somme(b) = 6.9
?>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-unique">
- <refnamediv>
- <refname>array_unique</refname>
- <refpurpose>Dédoublonne un tableau</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_unique</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_unique</function> prend le tableau
- <parameter>array</parameter> et retourne un nouveau tableau,
- complètement dédoublonné.
- Notez que les clés sont préservées.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>array_unique</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-unique">
+ <refnamediv>
+ <refname>array_unique</refname>
+ <refpurpose>Dédoublonne un tableau</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_unique</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_unique</function> prend le tableau
+ <parameter>array</parameter> et retourne un nouveau tableau,
+ complètement dédoublonné.
+ Notez que les clés sont préservées.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_unique</function></title>
+ <programlisting role="php">
<?php
$input = array ("a" => "vert", "rouge", "b" => "vert", "bleu", "rouge");
$result = array_unique ($input);
?>
- </programlisting>
- </example>
- </para>
- <para>
- <varname>$result</varname> contient
- <literal>array ("a" => "vert", "rouge", "bleu");</literal>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-unshift">
- <refnamediv>
- <refname>array_unshift</refname>
- <refpurpose>
- Empile un ou plusieurs éléments au début d'un
- tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>array_unshift</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>mixed <parameter>var</parameter></paramdef>
- <paramdef>
- <parameter>
- <optional>...</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_unshift</function> ajoute les éléments passé
- en argument au début du tableau <parameter>array</parameter>. Notez que
- les éléments sont ajoutés comme un tout, et qu'ils restent
- dans le même ordre.
- </para>
- <para>
- Retourne le nouveau nombre d'éléments du tableau
- <parameter>array</parameter>.
- </para>
- <para>
- <example>
- <title>Exemples avec <function>array_unshift</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <varname>$result</varname> contient
+ <literal>array ("a" => "vert", "rouge", "bleu");</literal>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-unshift">
+ <refnamediv>
+ <refname>array_unshift</refname>
+ <refpurpose>
+ Empile un ou plusieurs éléments au début d'un
+ tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>array_unshift</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>mixed <parameter>var</parameter></paramdef>
+ <paramdef>
+ <parameter>
+ <optional>...</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_unshift</function> ajoute les éléments passé
+ en argument au début du tableau <parameter>array</parameter>. Notez que
+ les éléments sont ajoutés comme un tout, et qu'ils restent
+ dans le même ordre.
+ </para>
+ <para>
+ Retourne le nouveau nombre d'éléments du tableau
+ <parameter>array</parameter>.
+ </para>
+ <para>
+ <example>
+ <title>Exemples avec <function>array_unshift</function></title>
+ <programlisting role="php">
<?php
$queue = array("p1", "p3");
array_unshift($queue, "p4", "p5", "p6");
?>
- </programlisting>
- </example>
- Le résultat de cet exemple est que $queue aura 5 éléments,
- à savoir: "p4", "p5", "p6", "p1", et "p3".
- </para>
- <para>
- Voir aussi <function>array_shift</function>,
- <function>array_push</function>, et
- <function>array_pop</function>.
- <note>
- <para>
- <function>array_unshift</function> a été ajoutée dans PHP
4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-values">
- <refnamediv>
- <refname>array_values</refname>
- <refpurpose>Retourne les valeurs d'un tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>array_values</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_values</function>retourne les valeurs du tableau
- <parameter>input</parameter>.
- </para>
- <para>
- <example>
- <title>Exemples avec <function>array_values</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ Le résultat de cet exemple est que $queue aura 5 éléments,
+ à savoir: "p4", "p5", "p6", "p1", et "p3".
+ </para>
+ <para>
+ Voir aussi
+ <function>array_shift</function>,
+ <function>array_push</function>, et
+ <function>array_pop</function>.
+ <note>
+ <para>
+ <function>array_unshift</function> a été ajoutée dans PHP
+4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-values">
+ <refnamediv>
+ <refname>array_values</refname>
+ <refpurpose>Retourne les valeurs d'un tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_values</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_values</function>retourne les valeurs du tableau
+ <parameter>input</parameter>.
+ </para>
+ <para>
+ <example>
+ <title>Exemples avec <function>array_values</function></title>
+ <programlisting role="php">
<?php
$array = array("taille" => "XL", "couleur" => "or");
array_values($array); // // retourne array("XL", "or")
?>
- </programlisting>
- </example>
- <note>
+ </programlisting>
+ </example>
+ <note>
<para>
<function>array_values</function> a été ajoutée dans PHP 4.
Ci dessous, voici une implémentation pour ceux qui utilisent
toujours PHP 3.
<example>
<title>
- Implémentation de <function>array_values</function> pour les utilisateurs
- PHP 3
+ Implémentation de <function>array_values</function> pour les
+utilisateurs
+ PHP 3
</title>
<programlisting role="php">
<?php
@@ -1554,110 +1566,114 @@
}
}
?>
- </programlisting>
+ </programlisting>
</example>
</para>
</note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-walk">
+ <refnamediv>
+ <refname>array_walk</refname>
+ <refpurpose>
+ Exécute une fonction sur chacun des membres d'un tableau.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>array_walk</function></funcdef>
+ <paramdef>array <parameter>arr</parameter></paramdef>
+ <paramdef>string <parameter>func</parameter></paramdef>
+ <paramdef>mixed <parameter>userdata</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ <function>array_walk</function> exécute la fonction
+<parameter>func</parameter>
+ avec chaque élément du tableau <parameter>arr</parameter>. Les
+ éléments sont passés en tant que premier argument de la
+ fonction <parameter>func</parameter>;
+ </simpara>
+ <simpara>
+ Si <parameter>func</parameter> a besoin de plus d'un argument, une alerte
+ sera générée pour chaque appel de
+<parameter>func</parameter>.
+ Ces alertes sont supprimées en ajoutant le suffixe '@' avant l'appel de
+ <function>array_walk</function> ou simplement en utilisant
+ <function>error_reporting</function>.
+ </simpara>
+ <note>
+ <para>
+ Si <parameter>func</parameter> doit travailler avec les véritables
+ valeur du tableau, spécifiez que le premier paramètre de
+ <parameter>func</parameter> doit être passé par
+ référence. Alors, les éléments seront directement
+ modifiés dans le tableau.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.array-walk">
- <refnamediv>
- <refname>array_walk</refname>
- <refpurpose>
- Exécute une fonction sur chacun des membres d'un tableau.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>array_walk</function></funcdef>
- <paramdef>array <parameter>arr</parameter></paramdef>
- <paramdef>string <parameter>func</parameter></paramdef>
- <paramdef>mixed <parameter>userdata</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- <function>array_walk</function> exécute la fonction
<parameter>func</parameter>
- avec chaque élément du tableau <parameter>arr</parameter>. Les
- éléments sont passés en tant que premier argument de la
- fonction <parameter>func</parameter>;
- </simpara>
- <simpara>
- Si <parameter>func</parameter> a besoin de plus d'un argument, une alerte
- sera générée pour chaque appel de
<parameter>func</parameter>.
- Ces alertes sont supprimées en ajoutant le suffixe '@' avant l'appel de
- <function>array_walk</function> ou simplement en utilisant
- <function>error_reporting</function>.
- </simpara>
- <note>
- <para>
- Si <parameter>func</parameter> doit travailler avec les véritables
- valeur du tableau, spécifiez que le premier paramètre de
- <parameter>func</parameter> doit être passé par
- référence. Alors, les éléments seront directement
- modifiés dans le tableau.
- </para>
- </note>
- <note>
- <para>
- Passez les clés et userdata à <parameter>func</parameter>
- a été ajouté dans PHP 4.0.
- </para>
- <para>
- Dans PHP 4, <function>reset</function> doit être appelés si
- nécessaire, car <function>array_walk</function> ne réinitialise
pas
- automatiquement le tableau.
- </para>
- </note>
+ </note>
+ <note>
<para>
- <example>
- <title>Exemple avec <function>array_walk</function></title>
- <programlisting role="php">
-<?php
-$fruits = array("d"=>"citron","a"=>"orange","b"=>"banane","c"=>"pomme");
-function test_alter( $item1 ) {
- $item1 = 'bidon';
-}
-function test_print( $item2 ) {
- echo "$item2<br>\n";
-}
-array_walk( $fruits, 'test_print' );
-array_walk( $fruits, 'test_alter' );
-array_walk( $fruits, 'test_print' );
-?>
- </programlisting>
- </example>
+ Passez les clés et userdata à <parameter>func</parameter>
+ a été ajouté dans PHP 4.0.
</para>
- <simpara>
- Voir aussi <function>each</function> et <function>list</function>.
- </simpara>
- </refsect1>
- </refentry>
- <refentry id="function.arsort">
- <refnamediv>
- <refname>arsort</refname>
- <refpurpose>
- Trie un tableau en ordre inverse
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>arsort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
<para>
- <function>arsort</function> trie un tableau de telle manière
- que la corrélation entre les index et les valeurs soient
- conservées. L'usage principal est lors de tri de tableaux
- associatifs oú l'ordre des éléments est important.
- <example>
- <title>Exemple avec <function>arsort</function></title>
- <programlisting role="php">
+ Dans PHP 4, <function>reset</function> doit être appelés si
+ nécessaire, car <function>array_walk</function> ne réinitialise pas
+ automatiquement le tableau.
+ </para>
+ </note>
+ <para>
+ <example>
+ <title>Exemple avec <function>array_walk</function></title>
+ <programlisting role="php">
+<?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<br>\n";
+}
+array_walk ($fruits, 'test_print');
+reset ($fruits);
+array_walk ($fruits, 'test_alter', 'fruit');
+reset ($fruits);
+array_walk ($fruits, 'test_print');
+?>
+ </programlisting>
+ </example>
+ </para>
+ <simpara>
+ Voir aussi
+ <function>each</function> et
+ <function>list</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+ <refentry id="function.arsort">
+ <refnamediv>
+ <refname>arsort</refname>
+ <refpurpose>
+ Trie un tableau en ordre inverse
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>arsort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>arsort</function> trie un tableau de telle manière
+ que la corrélation entre les index et les valeurs soient
+ conservées. L'usage principal est lors de tri de tableaux
+ associatifs ooúugrave; l'ordre des éléments est important.
+ <example>
+ <title>Exemple avec <function>arsort</function></title>
+ <programlisting role="php">
<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
arsort ($fruits);
@@ -1665,45 +1681,48 @@
echo "fruits[$key] = ".$fruits[$key]."\n";
}
?>
- </programlisting>
- </example>
-Cet exemple va afficher:
- <computeroutput>
-fruits[a] = orange
-fruits[d] = papaye
-fruits[b] = banane
-fruits[c] = ananas
- </computeroutput>
- Les fruits ont été triés en ordre alphabétique
- inverse, et leur index respectifs ont été conservé.
- </para>
- <para>
- Voir aussi: <function>asort</function>, <function>rsort</function>,
- <function>ksort</function>, et <function>sort</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.asort">
- <refnamediv>
- <refname>asort</refname>
- <refpurpose>Trie un tableau en ordre</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>asort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
+ </programlisting>
+ </example>
+ Cet exemple va afficher:
+ <computeroutput>
+ fruits[a] = orange
+ fruits[d] = papaye
+ fruits[b] = banane
+ fruits[c] = ananas
+ </computeroutput>
+ Les fruits ont été triés en ordre alphabétique
+ inverse, et leur index respectifs ont été conservé.
+ </para>
+ <para>
+ Voir aussi
+ <function>asort</function>,
+ <function>rsort</function>,
+ <function>ksort</function> et
+ <function>sort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.asort">
+ <refnamediv>
+ <refname>asort</refname>
+ <refpurpose>Trie un tableau en ordre</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>asort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
<function>asort</function> trie un tableau de telle manière que
la corrélation entre les index et les valeurs soient conservées.
- L'usage principal est lors de tri de tableaux associatifs oú l'ordre
+ L'usage principal est lors de tri de tableaux associatifs ooúugrave;
+l'ordre
des éléments est important.
- <example>
- <title>Exemple avec <function>asort</function></title>
- <programlisting role="php">
+ <example>
+ <title>Exemple avec <function>asort</function></title>
+ <programlisting role="php">
<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
asort($fruits);
@@ -1711,60 +1730,63 @@
echo "fruits[$key] = ".$fruits[$key]."\n";
}
?>
- </programlisting>
- </example>
- Cet exemple va afficher:
- <computeroutput>
-fruits[c] = ananas
-fruits[b] = banane
-fruits[d] = papaye
-fruits[a] = orange
- </computeroutput>
- Les fruits ont été triés par ordre alphabétique,
- et leur index respectifs ont été conservé.
- </para>
- <para>
- Voir aussi <function>arsort</function>, <function>rsort</function>,
- <function>ksort</function>, et <function>sort</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.compact">
- <refnamediv>
- <refname>compact</refname>
- <refpurpose>
- Crée un tableau contenant les variables et leur valeur
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>compact</function></funcdef>
- <paramdef><parameter>string varname | array
+ </programlisting>
+ </example>
+ Cet exemple va afficher:
+ <computeroutput>
+ fruits[c] = ananas
+ fruits[b] = banane
+ fruits[d] = papaye
+ fruits[a] = orange
+ </computeroutput>
+ Les fruits ont été triés par ordre alphabétique,
+ et leur index respectifs ont été conservé.
+ </para>
+ <para>
+ Voir aussi
+ <function>arsort</function>,
+ <function>rsort</function>,
+ <function>ksort</function> et
+ <function>sort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.compact">
+ <refnamediv>
+ <refname>compact</refname>
+ <refpurpose>
+ Crée un tableau contenant les variables et leur valeur
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>compact</function></funcdef>
+ <paramdef><parameter>string varname | array
varnames</parameter></paramdef>
- <paramdef>
+ <paramdef>
<parameter><optional>...</optional></parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>compact</function> accepte différents paramètres. Les
- paramètres peuvent être des variables contenant des chaînes,
- ou un tableau de chaîne, qui peut contenir d'autres tableau de noms, que
- <function>compact</function> traitera récursivement.
- </para>
- <para>
- Pour chacun des arguments, <function>compact</function> recherche une variable
- avec une variable de même nom dans la table courante des symboles, et
- l'ajoute dans le tableau, de manière à avoir la relation nom =>
- 'valeur de variable'. En bref, c'est le contraire de la fonction
- <function>extract</function>. Retourne le tableau ainsi créé.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>compact</function></title>
- <programlisting role="php">
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>compact</function> accepte différents paramètres. Les
+ paramètres peuvent être des variables contenant des chaînes,
+ ou un tableau de chaîne, qui peut contenir d'autres tableau de noms, que
+ <function>compact</function> traitera récursivement.
+ </para>
+ <para>
+ Pour chacun des arguments, <function>compact</function> recherche une variable
+ avec une variable de même nom dans la table courante des symboles, et
+ l'ajoute dans le tableau, de manière à avoir la relation nom =>
+ 'valeur de variable'. En bref, c'est le contraire de la fonction
+ <function>extract</function>. Retourne le tableau ainsi créé.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>compact</function></title>
+ <programlisting role="php">
<?php
$ville = "San Francisco";
$etat = "CA";
@@ -1772,61 +1794,62 @@
$location_vars = array("ville", "etat");
$result = compact("evenement", $location_vars);
?>
- </programlisting>
- <para>
- Après cette opération, $result sera le tableau suivant :
- array(("evenement" => "SIGGRAPH", "ville" => "San Francisco", "etat"
=> "CA").
- </para>
- </example>
- </para>
- <para>
- Voir aussi <function>extract</function>.
- <note>
- <para>
- <function>compact</function> a été ajoutée dans PHP 4.0.
- </para>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.count">
- <refnamediv>
- <refname>count</refname>
- <refpurpose>Compte le nombre d'élément d'un tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>count</function></funcdef>
- <paramdef>mixed <parameter>var</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>count</function> retourne le nombre d'élément dans
- <parameter>var</parameter>, qui est généralement un tableau
- (et tout le reste n'aura qu'un élément).
- </para>
- <para>
- Retourne 1 si la variable n'est pas un tableau.
- </para>
- <para>
- Retourne 0 si la variable n'est pas créée.
- </para>
+ </programlisting>
+ <para>
+ Après cette opération, $result sera le tableau suivant :
+ array(("evenement" => "SIGGRAPH", "ville" => "San Francisco", "etat"
+=> "CA").
+ </para>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>extract</function>.
+ <note>
+ <para>
+ <function>compact</function> a été ajoutée dans PHP 4.0.
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.count">
+ <refnamediv>
+ <refname>count</refname>
+ <refpurpose>Compte le nombre d'élément d'un tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>count</function></funcdef>
+ <paramdef>mixed <parameter>var</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>count</function> retourne le nombre d'élément dans
+ <parameter>var</parameter>, qui est généralement un tableau
+ (et tout le reste n'aura qu'un élément).
+ </para>
+ <para>
+ Retourne 1 si la variable n'est pas un tableau.
+ </para>
+ <para>
+ Retourne 0 si la variable n'est pas créée.
+ </para>
+ <para>
+ <warning>
<para>
- <warning>
- <para>
- <function>count</function> peut retourner 0 pour une
- variable qui n'a pas été affectée, ou pour un tableau
- vide. Utilisez plutôt <function>isset</function>
- pour tester si la variable existe.
- </para>
- </warning>
+ <function>count</function> peut retourner 0 pour une
+ variable qui n'a pas été affectée, ou pour un tableau
+ vide. Utilisez plutôt <function>isset</function>
+ pour tester si la variable existe.
</para>
- <para>
- <example>
- <title>Exemple avec <function>count</function></title>
- <programlisting role="php">
+ </warning>
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>count</function></title>
+ <programlisting role="php">
<?php
$a[0] = 1;
$a[1] = 3;
@@ -1834,131 +1857,135 @@
$result = count ($a);
//$result == 3
?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi: <function>sizeof</function>,
- <function>isset</function>, et
- <function>is_array</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.current">
- <refnamediv>
- <refname>current</refname>
- <refpurpose>Transforme une variable en tableau</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>current</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Chaque tableau entretien un pointeur interne, qui est initialisé lors
- lorsque le premier élément est inséré dans le
tableau.
- </para>
- <para>
- <function>current</function> ne fait que retourner
- l'élément courant pointé par le pointeur interne.
- <function>current</function> ne déplace pas le pointeur.
- Si le pointeur est au dela du dernier élément de la liste,
- <function>current</function> retourne <literal>FALSE</literal>.
- <warning>
- <para>
- Si le tableau des éléments vides ou des zéros (0 ou "",
- la chaîne vide) alors <function>current</function> retournera
- <literal>FALSE</literal> pour ces éléments. Il est donc
- impossible de déterminer si vous êtes réellement
- à la fin de la liste en utilisant la fonction
- <function>current</function>. Pour passer en revue proprement un
- tableau qui peut contenir des éléments vides ou des zéros,
- utilisez la fonction <function>each</function>.
- </para>
- </warning>
- </para>
- <para>
- Voir aussi: <function>end</function>, <function>next</function>,
- <function>prev</function> et <function>reset</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.each">
- <refnamediv>
- <refname>each</refname>
- <refpurpose>
- Retourne chaque paire clé/valeur d'un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>each</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>each</function> retourne la paire (clé/valeur) courante
- du tableau <parameter>array</parameter> et avance le pointeur de tableau.
- Cette paire est retournée dans un tableau de 4 éléments,
- avec les clés <emphasis>0</emphasis>, <emphasis>1</emphasis>,
- <emphasis>key</emphasis>, et <emphasis>value</emphasis>. Les
- éléments <emphasis>0</emphasis> et <emphasis>key</emphasis>
- contiennent le nom de la clé et, et <emphasis>1</emphasis> et
- <emphasis>value</emphasis> contiennent la valeur.
- </para>
- <para>
- Si le pointeur interne de fichier est au delà de la fin du tableau,
- <function>each</function> retourne <literal>FALSE</literal>.
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>sizeof</function>,
+ <function>isset</function> et
+ <function>is_array</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.current">
+ <refnamediv>
+ <refname>current</refname>
+ <refpurpose>Transforme une variable en tableau</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>current</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Chaque tableau entretien un pointeur interne, qui est initialisé lors
+ lorsque le premier élément est inséré dans le tableau.
+ </para>
+ <para>
+ <function>current</function> ne fait que retourner
+ l'élément courant pointé par le pointeur interne.
+ <function>current</function> ne déplace pas le pointeur.
+ Si le pointeur est au dela du dernier élément de la liste,
+ <function>current</function> retourne <literal>FALSE</literal>.
+ <warning>
+ <para>
+ Si le tableau des éléments vides ou des zéros (0 ou "",
+ la chaîne vide) alors <function>current</function> retournera
+ <literal>FALSE</literal> pour ces éléments. Il est donc
+ impossible de déterminer si vous êtes réellement
+ à la fin de la liste en utilisant la fonction
+ <function>current</function>. Pour passer en revue proprement un
+ tableau qui peut contenir des éléments vides ou des zéros,
+ utilisez la fonction <function>each</function>.
</para>
- <para>
- <example>
- <title>Exemples avec <function>each</function></title>
- <programlisting role="php">
+ </warning>
+ </para>
+ <para>
+ Voir aussi
+ <function>end</function>,
+ <function>next</function>,
+ <function>prev</function> et
+ <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.each">
+ <refnamediv>
+ <refname>each</refname>
+ <refpurpose>
+ Retourne chaque paire clé/valeur d'un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>each</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>each</function> retourne la paire (clé/valeur) courante
+ du tableau <parameter>array</parameter> et avance le pointeur de tableau.
+ Cette paire est retournée dans un tableau de 4 éléments,
+ avec les clés <emphasis>0</emphasis>, <emphasis>1</emphasis>,
+ <emphasis>key</emphasis>, et <emphasis>value</emphasis>. Les
+ éléments <emphasis>0</emphasis> et <emphasis>key</emphasis>
+ contiennent le nom de la clé et, et <emphasis>1</emphasis> et
+ <emphasis>value</emphasis> contiennent la valeur.
+ </para>
+ <para>
+ Si le pointeur interne de fichier est au delà de la fin du tableau,
+ <function>each</function> retourne <literal>FALSE</literal>.
+ </para>
+ <para>
+ <example>
+ <title>Exemples avec <function>each</function></title>
+ <programlisting role="php">
<?php
$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);
?>
- </programlisting>
- <para>
- <literal>$bar</literal> contient maintenant les paires suivantes:
- <itemizedlist spacing="compact">
- <listitem><simpara>0 => 0</simpara></listitem>
- <listitem><simpara>1 => 'bob'</simpara></listitem>
- <listitem><simpara>key => 0</simpara></listitem>
- <listitem><simpara>value => 'bob'</simpara></listitem>
- </itemizedlist>
- <programlisting role="php">
+ </programlisting>
+ <para>
+ <literal>$bar</literal> contient maintenant les paires suivantes:
+ <itemizedlist spacing="compact">
+ <listitem><simpara>0 => 0</simpara></listitem>
+ <listitem><simpara>1 => 'bob'</simpara></listitem>
+ <listitem><simpara>key => 0</simpara></listitem>
+ <listitem><simpara>value => 'bob'</simpara></listitem>
+ </itemizedlist>
+ <programlisting role="php">
<?php
$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);
?>
</programlisting>
- </para>
- <para>
- <literal>$bar</literal> contient maintenant les paires suivantes:
- <itemizedlist spacing="compact">
- <listitem><simpara>0 => 'Robert'</simpara></listitem>
- <listitem><simpara>1 => 'Bob'</simpara></listitem>
- <listitem><simpara>key => 'Robert'</simpara></listitem>
- <listitem><simpara>value => 'Bob'</simpara></listitem>
- </itemizedlist>
- </para>
- </example>
- </para>
- <para>
- <function>each</function> est utilisé conjointement avec
- <function>list</function> pour étudier tous les éléments
- d'un tableau; par exemple, $HTTP_POST_VARS:
- <example>
- <title>
- Affichage de $HTTP_POST_VARS avec <function>each</function>
- </title>
- <programlisting role="php">
+ </para>
+ <para>
+ <literal>$bar</literal> contient maintenant les paires suivantes:
+ <itemizedlist spacing="compact">
+ <listitem><simpara>0 => 'Robert'</simpara></listitem>
+ <listitem><simpara>1 => 'Bob'</simpara></listitem>
+ <listitem><simpara>key => 'Robert'</simpara></listitem>
+ <listitem><simpara>value => 'Bob'</simpara></listitem>
+ </itemizedlist>
+ </para>
+ </example>
+ </para>
+ <para>
+ <function>each</function> est utilisé conjointement avec
+ <function>list</function> pour étudier tous les éléments
+ d'un tableau; par exemple, $HTTP_POST_VARS:
+ <example>
+ <title>
+ Affichage de $HTTP_POST_VARS avec <function>each</function>
+ </title>
+ <programlisting role="php">
<?php
echo "Valeurs transmises par la méthode POST:<br>";
reset ($HTTP_POST_VARS);
@@ -1966,159 +1993,166 @@
echo "$key => $val<br>";
}
?>
- </programlisting>
- </example>
- </para>
- <para>
- Après chaque <function>each</function>, le pointeur de tableau est
- déplacé au dernier éléments, ou sur le dernier
- élément, lorsqu'on arrive à la fin.
- </para>
- <para>
- Voir aussi <function>key</function>, <function>list</function>,
- <function>current</function>, <function>reset</function>,
- <function>next</function>, et <function>prev</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.end">
- <refnamediv>
- <refname>end</refname>
- <refpurpose>
- Positionne le pointeur de tableau en fin de tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef><function>end</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>end</function> déplace le pointeur interne du tableau
- <parameter>array</parameter> jusqu'au dernier élément.
- </para>
- <para>
- Voir aussi: <function>current</function>,
- <function>each</function>, <function>end</function>,
- <function>next</function>, et <function>reset</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.extract">
- <refnamediv>
- <refname>extract</refname>
- <refpurpose>
- Importe les variables dans la table des symboles
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>extract</function></funcdef>
- <paramdef>array <parameter>var_array</parameter></paramdef>
- <paramdef>int
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Après chaque <function>each</function>, le pointeur de tableau est
+ déplacé au dernier éléments, ou sur le dernier
+ élément, lorsqu'on arrive à la fin.
+ </para>
+ <para>
+ Voir aussi
+ <function>key</function>,
+ <function>list</function>,
+ <function>current</function>,
+ <function>reset</function>,
+ <function>next</function> et
+ <function>prev</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.end">
+ <refnamediv>
+ <refname>end</refname>
+ <refpurpose>
+ Positionne le pointeur de tableau en fin de tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef><function>end</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>end</function> déplace le pointeur interne du tableau
+ <parameter>array</parameter> jusqu'au dernier élément.
+ </para>
+ <para>
+ Voir aussi
+ <function>current</function>,
+ <function>each</function>,
+ <function>end</function>,
+ <function>next</function> et
+ <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.extract">
+ <refnamediv>
+ <refname>extract</refname>
+ <refpurpose>
+ Importe les variables dans la table des symboles
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>extract</function></funcdef>
+ <paramdef>array <parameter>var_array</parameter></paramdef>
+ <paramdef>int
<parameter><optional>extract_type</optional></parameter>
</paramdef>
- <paramdef>string
+ <paramdef>string
<parameter><optional>prefix</optional></parameter>
</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>extract</function> sert à exporter un tableau vers
- la table des symboles. Elle prend un tableau associatif
- <parameter>var_array</parameter> et crée les variables dont les
- noms sont les index de ce tableau, et leur affecte la valeur associée.
- Pour chaque paire clé/valeur, <function>extract</function> crée
- une variable, avec les paramètres <parameter>extract_type</parameter>
- et <parameter>prefix</parameter>.
- </para>
- <note>
- <para>
- Depuis la version 4.0.5, <function>extract</function> retourne le nombre de
- variables extraites.
- </para>
- </note>
- <para>
- <function>extract</function> vérifie l'existence de la variable avant
- de la créer. Le traitement des les collisions est
- déterminée par <parameter>extract_type</parameter>.
- Ce paramètre peut prendre une des valeurs suivantes :
- <variablelist>
- <varlistentry>
- <term>EXTR_OVERWRITE</term>
- <listitem>
- <simpara>
- Lors d'une collision, réécrire la variable existante.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_SKIP</term>
- <listitem>
- <simpara>
- Lors d'une collision, ne pas réécrire la variable existante.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_PREFIX_SAME</term>
- <listitem>
- <simpara>
- Lors d'une collision, ajouter le préfixe
<parameter>prefix</parameter>,
- et créer une nouvelle variable.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_PREFIX_ALL</term>
- <listitem>
- <simpara>
- Ajouter le préfixe <parameter>prefix</parameter>, et créer
- une nouvelle variable.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_PREFIX_INVALID</term>
- <listitem>
- <simpara>
- Préfixer uniquement les variables aux noms invalides ou
numériques
- avec le préfixe <parameter>prefix</parameter>. Ceci a
été ajouté
- en PHP 4.0.5.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- Si <parameter>extract_type</parameter> est omis, <function>extract</function>
- utilise EXTR_OVERWRITE par défault.
- </para>
- <para>
- Notez que <parameter>prefix</parameter> n'est nécessaire que pour
- les valeurs de <parameter>extract_type</parameter> suivantes :
- EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat
- préfixé n'est pas un nom de variable valide, il ne sera pas
importé dans
- la table des symboles.
- </para>
- <para>
- <function>extract</function> retourne le nombre de variables
rééllement
- importées dans la table des symbols.
- </para>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>extract</function> sert à exporter un tableau vers
+ la table des symboles. Elle prend un tableau associatif
+ <parameter>var_array</parameter> et crée les variables dont les
+ noms sont les index de ce tableau, et leur affecte la valeur associée.
+ Pour chaque paire clé/valeur, <function>extract</function> crée
+ une variable, avec les paramètres <parameter>extract_type</parameter>
+ et <parameter>prefix</parameter>.
+ </para>
+ <note>
<para>
- Une utilisation possible de <function>extract</function> est l'exportation
- vers la table des symboles de tableau de variables retourné
- par <function>wddx_deserialize</function>.
+ Depuis la version 4.0.5, <function>extract</function> retourne le nombre de
+ variables extraites.
</para>
- <para>
- <example>
- <title>Exemple avec <function>extract</function></title>
- <programlisting role="php">
+ </note>
+ <para>
+ <function>extract</function> vérifie l'existence de la variable avant
+ de la créer. Le traitement des les collisions est
+ déterminée par <parameter>extract_type</parameter>.
+ Ce paramètre peut prendre une des valeurs suivantes :
+ <variablelist>
+ <varlistentry>
+ <term>EXTR_OVERWRITE</term>
+ <listitem>
+ <simpara>
+ Lors d'une collision, réécrire la variable existante.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>EXTR_SKIP</term>
+ <listitem>
+ <simpara>
+ Lors d'une collision, ne pas réécrire la variable existante.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>EXTR_PREFIX_SAME</term>
+ <listitem>
+ <simpara>
+ Lors d'une collision, ajouter le préfixe <parameter>prefix</parameter>,
+ et créer une nouvelle variable.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>EXTR_PREFIX_ALL</term>
+ <listitem>
+ <simpara>
+ Ajouter le préfixe <parameter>prefix</parameter>, et créer
+ une nouvelle variable.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>EXTR_PREFIX_INVALID</term>
+ <listitem>
+ <simpara>
+ Préfixer uniquement les variables aux noms invalides ou numériques
+ avec le préfixe <parameter>prefix</parameter>. Ceci a
+ été ajouté en PHP 4.0.5.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ Si <parameter>extract_type</parameter> est omis, <function>extract</function>
+ utilise EXTR_OVERWRITE par défault.
+ </para>
+ <para>
+ Notez que <parameter>prefix</parameter> n'est nécessaire que pour
+ les valeurs de <parameter>extract_type</parameter> suivantes :
+ EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat
+ préfixé n'est pas un nom de variable valide,
+ il ne sera pas importé dans la table des symboles.
+ </para>
+ <para>
+ <function>extract</function> retourne le nombre de variables
+rééllement
+ importées dans la table des symbols.
+ </para>
+ <para>
+ Une utilisation possible de <function>extract</function> est l'exportation
+ vers la table des symboles de tableau de variables retourné
+ par <function>wddx_deserialize</function>.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>extract</function></title>
+ <programlisting role="php">
<?php
/* Supposons que $var_array est un tableau retourné par
<function>wddx_deserialize</function> */
@@ -2129,177 +2163,181 @@
extract($var_array, EXTR_PREFIX_SAME, "wddx");
print "$couleur, $taille, $forme, $wddx_taille\n";
?>
- </programlisting>
- </example>
- </para>
- <para>
- L'exemple ci dessus va afficher
- <computeroutput>
-bleu, large, sphere, moyen
- </computeroutput>
- </para>
- <para>
- La variable $taille n'a pas été réécrite, car on
- avait spécifié le paramètre EXTR_PREFIX_SAME, qui a permis
- la création $wddx_size. Si EXTR_SKIP avait été
- utilisé, alors $wddx_size n'aurait pas été
- créé. Avec EXTR_OVERWRITE, $taille aurait pris la valeur "moyen",
- et avec EXTR_PREFIX_ALL, les variables créées seraient
- $wddx_couleur, $wddx_taille, et $wddx_forme.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.in-array">
- <refnamediv>
- <refname>in_array</refname>
- <refpurpose>
- Indique si une valeur appartient à un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>in_array</function></funcdef>
- <paramdef>mixed <parameter>needle</parameter></paramdef>
- <paramdef>array <parameter>haystack</parameter></paramdef>
- <paramdef>bool <parameter>strict</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>in_array</function> recherche <parameter>needle</parameter> dans
- <parameter>haystack</parameter> et retourne <literal>TRUE</literal>
- si il s'y trouve, ou <literal>FALSE</literal> sinon.
- </para>
- <para>
- Si le troisième paramètre <parameter>strict</parameter> est
optionel. S'il
- vaut <literal>TRUE</literal> alors <function>in_array</function>
- vérifiera aussi les types du paramètre
<parameter>needle</parameter>
- dans <parameter>haystack</parameter>.
- </para>
- <para>
- <example>
- <title>Exemple avec <function>in_array</function></title>
- <programlisting role="php">
-<?php
-$os = array("Mac", "NT", "Irix", "Linux");
-if (in_array("Irix", $os))
- print "Irix trouve";
-?>
- </programlisting>
- </example>
- </para>
- <para>
- <example>
- <title>
- <function>in_array</function> avec le paramètre
<parameter>strict</parameter>
- </title>
- <programlisting role="php">
-<?php
-$a = array('1.10', 12.4, 1.13);
-if (in_array('12.4', $a, <literal>TRUE</literal>))
- echo "'12.4' trouvé avec une recherche stricte\n";
-if (in_array(1.13, $a, <literal>TRUE</literal>))
- echo "1.13 trouvé avec une recherche stricte\n";
-?>
- </programlisting>
- </example>
- </para>
- <para>
- L'affichage sera :
- </para>
- <informalexample>
- <screen>
-1.13 trouvé avec une recherche stricte
- </screen>
- </informalexample>
- <note>
- <para>
- <function>in_array</function> a été ajoutée dans PHP 4.0.
- </para>
- </note>
- <para>
- Voir aussi <function>array_search</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.array-search">
- <refnamediv>
- <refname>array_search</refname>
- <refpurpose>
- Recherche dans un tableau la clé associée à une valeur
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>array_search</function></funcdef>
- <paramdef>mixed <parameter>needle</parameter></paramdef>
- <paramdef>array <parameter>haystack</parameter></paramdef>
- <paramdef>bool <parameter>strict</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>array_search</function> recherche <parameter>needle</parameter>
- dans <parameter>haystack</parameter> et retourne la clé associée
s'il
- la trouve, ou <literal>FALSE</literal> sinon.
- </para>
- <para>
- Si le troisième paramètre <parameter>strict</parameter> vaut
- <literal>TRUE</literal>, alors <function>array_search</function>
- s'assurera aussi que le type de <parameter>needle</parameter>
- est le même que celui de la valeur trouvée dans
<parameter>haystack</parameter>.
- </para>
- <para>
- Voir aussi <function>in_array</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.key">
- <refnamediv>
- <refname>key</refname>
- <refpurpose>Retourne une clé d'un tableau associatif</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>key</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>key</function> retourne l'index de la clé courante dans un
- tableau.
- </para>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ L'exemple ci dessus va afficher
+ <computeroutput>
+ bleu, large, sphere, moyen
+ </computeroutput>
+ </para>
+ <para>
+ La variable $taille n'a pas été réécrite, car on
+ avait spécifié le paramètre EXTR_PREFIX_SAME, qui a permis
+ la création $wddx_size. Si EXTR_SKIP avait été
+ utilisé, alors $wddx_size n'aurait pas été
+ créé. Avec EXTR_OVERWRITE, $taille aurait pris la valeur "moyen",
+ et avec EXTR_PREFIX_ALL, les variables créées seraient
+ $wddx_couleur, $wddx_taille, et $wddx_forme.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.in-array">
+ <refnamediv>
+ <refname>in_array</refname>
+ <refpurpose>
+ Indique si une valeur appartient à un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>in_array</function></funcdef>
+ <paramdef>mixed <parameter>needle</parameter></paramdef>
+ <paramdef>array <parameter>haystack</parameter></paramdef>
+ <paramdef>bool <parameter><optional>strict</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>in_array</function> recherche <parameter>needle</parameter> dans
+ <parameter>haystack</parameter> et retourne <literal>TRUE</literal>
+ si il s'y trouve, ou <literal>FALSE</literal> sinon.
+ </para>
+ <para>
+ Si le troisième paramètre <parameter>strict</parameter> est
+optionel. S'il
+ vaut <literal>TRUE</literal> alors <function>in_array</function>
+ vérifiera aussi les types du paramètre <parameter>needle</parameter>
+ dans <parameter>haystack</parameter>.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>in_array</function></title>
+ <programlisting role="php">
+<?php
+$os = array("Mac", "NT", "Irix", "Linux");
+if (in_array("Irix", $os))
+ print "Irix trouve";
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>
+ <function>in_array</function> avec le paramètre
+<parameter>strict</parameter>
+ </title>
+ <programlisting role="php">
+<?php
+$a = array('1.10', 12.4, 1.13);
+if (in_array('12.4', $a, <literal>TRUE</literal>))
+ echo "'12.4' trouvé avec une recherche stricte\n";
+if (in_array(1.13, $a, <literal>TRUE</literal>))
+ echo "1.13 trouvé avec une recherche stricte\n";
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ L'affichage sera :
+ </para>
+ <informalexample>
+ <screen>
+ 1.13 trouvé avec une recherche stricte
+ </screen>
+ </informalexample>
+ <note>
<para>
- Voir aussi: <function>current</function>, et <function>next</function>
+ <function>in_array</function> a été ajoutée dans PHP 4.0.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.krsort">
- <refnamediv>
- <refname>krsort</refname>
- <refpurpose>
- Trie un tableau en sens inverse et suivant les clés
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>krsort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>krsort</function> trie un tableau en ordre inverse et suivant les
- clés, en maintenant la correspondance entre les clés et les
- valeurs. Cette fonction est pratique pour les tableaux associatifs.
- <example>
- <title>Exemple avec <function>krsort</function></title>
- <programlisting role="php">
+ </note>
+ <para>
+ Voir aussi
+ <function>array_search</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.array-search">
+ <refnamediv>
+ <refname>array_search</refname>
+ <refpurpose>
+ Recherche dans un tableau la clé associée à une valeur
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_search</function></funcdef>
+ <paramdef>mixed <parameter>needle</parameter></paramdef>
+ <paramdef>array <parameter>haystack</parameter></paramdef>
+ <paramdef>bool <parameter>strict</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_search</function> recherche <parameter>needle</parameter>
+ dans <parameter>haystack</parameter> et retourne la clé associée
+s'il
+ la trouve, ou <literal>FALSE</literal> sinon.
+ </para>
+ <para>
+ Si le troisième paramètre <parameter>strict</parameter> vaut
+ <literal>TRUE</literal>, alors <function>array_search</function>
+ s'assurera aussi que le type de <parameter>needle</parameter>
+ est le même que celui de la valeur trouvée dans
+<parameter>haystack</parameter>.
+ </para>
+ <para>
+ Voir aussi
+ <function>in_array</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.key">
+ <refnamediv>
+ <refname>key</refname>
+ <refpurpose>Retourne une clé d'un tableau associatif</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>key</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>key</function> retourne l'index de la clé courante dans un
+ tableau.
+ </para>
+ <para>
+ Voir aussi
+ <function>current</function> et
+ <function>next</function>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.krsort">
+ <refnamediv>
+ <refname>krsort</refname>
+ <refpurpose>
+ Trie un tableau en sens inverse et suivant les clés
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>krsort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>krsort</function> trie un tableau en ordre inverse et suivant les
+ clés, en maintenant la correspondance entre les clés et les
+ valeurs. Cette fonction est pratique pour les tableaux associatifs.
+ <example>
+ <title>Exemple avec <function>krsort</function></title>
+ <programlisting role="php">
<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
ksort($fruits);
@@ -2307,44 +2345,47 @@
echo "fruits[$key] = ".$fruits[$key]."\n";
}
?>
- </programlisting>
- </example>
- Cet exemple va afficher :
- <computeroutput>
-fruits[d] = citron
-fruits[c] = ananas
-fruits[b] = banane
-fruits[a] = orange
- </computeroutput>
- </para>
- <simpara>
- Voir aussi <function>asort</function>, <function>arsort</function>,
- <function>ksort</function> <function>sort</function>, et
- <function>rsort</function>.
- </simpara>
- </refsect1>
- </refentry>
- <refentry id="function.ksort">
- <refnamediv>
- <refname>ksort</refname>
- <refpurpose>Trie un tableau suivant les clés</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>ksort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
+ </programlisting>
+ </example>
+ Cet exemple va afficher :
+ <computeroutput>
+ fruits[d] = citron
+ fruits[c] = ananas
+ fruits[b] = banane
+ fruits[a] = orange
+ </computeroutput>
+ </para>
+ <simpara>
+ Voir aussi
+ <function>asort</function>,
+ <function>arsort</function>,
+ <function>ksort</function>,
+ <function>sort</function> et
+ <function>rsort</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ksort">
+ <refnamediv>
+ <refname>ksort</refname>
+ <refpurpose>Trie un tableau suivant les clés</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ksort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
<function>ksort</function> trie un tableau suivant les
clés, en maintenant la correspondance entre les
clés et les valeurs. Cette fonction est pratique
pour les tableaux associatifs.
- <example>
- <title>Exemple avec <function>ksort</function></title>
- <programlisting role="php">
+ <example>
+ <title>Exemple avec <function>ksort</function></title>
+ <programlisting role="php">
<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
ksort($fruits);
@@ -2353,108 +2394,113 @@
echo "$key => $val\n";
}
?>
- </programlisting>
- </example>
- Cet exemple va afficher :
- <computeroutput>
-fruits[a] = orange
-fruits[b] = banane
-fruits[c] = ananas
-fruits[d] = citron
- </computeroutput>
- </para>
+ </programlisting>
+ </example>
+ Cet exemple va afficher :
+ <computeroutput>
+ fruits[a] = orange
+ fruits[b] = banane
+ fruits[c] = ananas
+ fruits[d] = citron
+ </computeroutput>
+ </para>
+ <para>
+ Vous pouvez modifier le comportement du tri avec les
+ options <parameter>sort_flags</parameter>. Pour plus de
+ détails, voyez <function>sort</function>.
+ </para>
+ <simpara>
+ Voir aussi
+ <function>asort</function>,
+ <function>arsort</function>,
+ <function>sort</function> et
+ <function>rsort</function>.
+ </simpara>
+ <note>
<para>
- Vous pouvez modifier le comportement du tri avec les
- options <parameter>sort_flags</parameter>. Pour plus de
- détails, voyez <function>sort</function>.
+ Le second paramètre a été ajouté dans PHP 4.
</para>
- <simpara>
- Voir aussi <function>asort</function>, <function>arsort</function>,
- <function>sort</function>, et <function>rsort</function>.
- </simpara>
- <note>
- <para>
- Le second paramètre a été ajouté dans PHP 4.
- </para>
- </note>
- </refsect1>
- </refentry>
- <refentry id="function.list">
- <refnamediv>
- <refname>list</refname>
- <refpurpose>
- Transforme une liste de variables en tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>list</function></funcdef>
- <paramdef>void</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Tout comme <function>array</function>, <function>list</function> n'est pas une
- véritable fonction, mais une construction syntaxique,
- qui permet d'assigner une série de variable en une
- seule ligne.
- <example>
- <title>Exemple avec <function>list</function></title>
- <programlisting role="php">
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.list">
+ <refnamediv>
+ <refname>list</refname>
+ <refpurpose>
+ Transforme une liste de variables en tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>list</function></funcdef>
+ <paramdef>void</paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Tout comme <function>array</function>, <function>list</function> n'est pas une
+ véritable fonction, mais une construction syntaxique,
+ qui permet d'assigner une série de variable en une
+ seule ligne.
+ <example>
+ <title>Exemple avec <function>list</function></title>
+ <programlisting role="php">
<?php
-<table>
- <tr>
- <th>Employee name</th>
- <th>Salary</th>
- </tr>
-<?php
-$result = mysql ($conn, "SELECT id, name, salary FROM employees");
-while (list ($id, $name, $salary) = mysql_fetch_row ($result)) {
- print (" <tr>\n".
- " <td><a href=\"info.php3?id=$id\">$name</a></td>\n".
- " <td>$salary</td>\n".
- " </tr>\n");
+<table>
+ <tr>
+ <th>Nom de l'employé</th>
+ <th>Salaire</th>
+ </tr>
+<?php
+$result = mysql_query($conn, "SELECT id, name, salary FROM employees");
+while (list($id, $name, $salary) = mysql_fetch_row ($result)) {
+ print (" <tr>\n".
+ " <td><a
+href=\"info.php3?id=$id\">$name</a></td>\n".
+ " <td>$salaire</td>\n".
+ " </tr>\n");
}
?>
-</table>
+</table>
?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi: <function>each</function>, <function>array</function>.
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>each</function> et
+ <function>array</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.natsort">
- <refnamediv>
- <refname>natsort</refname>
- <refpurpose>
- Tri d'un tableau avec l'algorithme à "ordre naturel"
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>natsort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>natsort</function> implémente un algorithme
- de tri qui traite les chaînes alpha-numériques
- comme un être humain : c'est ce qui est appelé
- l'"ordre naturel". Un exemple de la différence de
- traitement entre un tel algorithme et un algorithme de tri de
- chaînes (comme lorsqu'on utilise <function>sort</function>)
- est illustré ci dessous :
- </para>
- <para>
- <example>
- <title>Exemple avec <function>natsort</function></title>
- <programlisting role="php">
+ <refnamediv>
+ <refname>natsort</refname>
+ <refpurpose>
+ Tri d'un tableau avec l'algorithme à "ordre naturel"
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>natsort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>natsort</function> implémente un algorithme
+ de tri qui traite les chaînes alpha-numériques
+ comme un être humain : c'est ce qui est appelé
+ l'"ordre naturel". Un exemple de la différence de
+ traitement entre un tel algorithme et un algorithme de tri de
+ chaînes (comme lorsqu'on utilise <function>sort</function>)
+ est illustré ci dessous :
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>natsort</function></title>
+ <programlisting role="php">
<?php
$array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png");
sort($array1);
@@ -2464,15 +2510,15 @@
echo "\nTri par Ordre Naturel\n";
print_r($array2);
?>
- </programlisting>
- </example>
- </para>
- <para>
- L'exemple ci dessous génère l'affichage suivant :
- </para>
- <para>
- <informalexample>
- <programlisting>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ L'exemple ci dessous génère l'affichage suivant :
+ </para>
+ <para>
+ <informalexample>
+ <programlisting>
Tri Standard
Array
(
@@ -2490,232 +2536,244 @@
[0] => img12.png
)
?>
- </programlisting>
- </informalexample>
- Pour plus de détails, rendez vous sur le site de Martin Pool
- <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
- </para>
- <para>
- Voir aussi <function>natcasesort</function>,
- <function>strnatcmp</function> et
- <function>strnatcasecmp</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.natcasesort">
- <refnamediv>
- <refname>natcasesort</refname>
- <refpurpose>
- Tri d'un tableau avec l'algorithme à "ordre naturel" insensible à
la casse
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>natcasesort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>natcasesort</function> implémente un algorithme
- de tri qui traite les chaînes alpha-numériques comme
- un être humain : c'est ce qui est appelé l'"ordre naturel".
- </para>
- <para>
- <function>natcasesort</function> est la version insensible à la
- casse de <function>natsort</function>. Voir aussi
- <function>natsort</function> pour un exemple illustré.
- </para>
- <para>
- Pour plus de détails, rendez vous sur le site de :
- Martin Pool's
- <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
- </para>
- <para>
- Voir aussi <function>sort</function>,
- <function>natsort</function>,
- <function>strnatcmp</function> et
- <function>strnatcasecmp</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.next">
- <refnamediv>
- <refname>next</refname>
- <refpurpose>
- Avance le pointeur interne d'un tableau
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>next</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>next</function> retourne l'élément suivant du tableau,
- ou <literal>FALSE</literal> si il n'y a plus d'éléments. Le
pointeur de interne de
- tableau est avancé d'un élément.
- </para>
- <para>
- <function>next</function> se comporte comme
- <function>current</function>, mais avec une différence : il avance le
- pointeur interne de tableau d'un élément avant de retourner la
- valeur qu'il pointe. Lorsque le pointeur dépasse le dernier
- élément, <function>next</function> retourne
<literal>FALSE</literal>.
- <warning>
- <para>
- Si le tableau contient des éléments vides ou des zéros,
- <function>next</function> retournera <literal>FALSE</literal> pour ces
éléments.
- Pour passer proprement en revue un tableau, il faut utiliser
- <function>each</function>.
- </para>
- </warning>
- </para>
- <para>
- Voir aussi:
- <function>current</function>, <function>end</function>
- <function>prev</function> et <function>reset</function>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.pos">
- <refnamediv>
- <refname>pos</refname>
- <refpurpose>Retourne l'élément courant d'un tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>pos</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- <function>pos</function> est une fonction alias de <function>current</function>.
- </simpara>
- <para>
- Voir aussi:
- <function>end</function>, <function>next</function>,
- <function>prev</function> et <function>reset</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.prev">
- <refnamediv>
- <refname>prev</refname>
- <refpurpose>Recule le pointeur courant de tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>prev</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>prev</function> repositionne le pointeur interne de tableau à
- la dernière place qu'il occupait, ou bien retourne
<literal>FALSE</literal> si il
- ne reste plus d'éléments.
- <warning>
- <para>
- Si le tableau contient des éléments vides,
- <function>prev</function> retournera <literal>FALSE</literal> pour ces
- éléments aussi. Pour passer en revue tous les
- éléments, utilisez plutôt <function>each</function>.
- </para>
- </warning>
- </para>
- <para>
- <function>prev</function> se comporte exactement comme
- <function>next</function>, mais il fait reculer le pointeur plutôt que
- de l'avancer.
- </para>
- <para>
- Voir aussi: <function>current</function>, <function>end</function>
- <function>next</function> et <function>reset</function>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.range">
- <refnamediv>
- <refname>range</refname>
- <refpurpose>
- Crée un tableau contenant un intervalle d'entiers
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>range</function></funcdef>
- <paramdef>int <parameter>low</parameter></paramdef>
- <paramdef>int <parameter>high</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>range</function> retourne un tableau contenant tous les entiers
- depuis <parameter>low</parameter> jusqu'à <parameter>high</parameter>,
- inclus.
- </para>
- <para>
- Voir <function>shuffle</function> pour un exemple d'utilisation.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.reset">
- <refnamediv>
- <refname>reset</refname>
- <refpurpose>
- Remet le pointeur interne de tableau au début
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>reset</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>reset</function> replace le pointeur de tableau
- <parameter>array</parameter> au premier élément.
- </para>
- <para>
- <function>reset</function> retourne la valeur du premier élément.
+ </programlisting>
+ </informalexample>
+ Pour plus de détails, rendez vous sur le site de Martin Pool
+ <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
+ </para>
+ <para>
+ Voir aussi
+ <function>natcasesort</function>,
+ <function>strnatcmp</function> et
+ <function>strnatcasecmp</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.natcasesort">
+ <refnamediv>
+ <refname>natcasesort</refname>
+ <refpurpose>
+ Tri d'un tableau avec l'algorithme à "ordre naturel" insensible à
+la casse
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>natcasesort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>natcasesort</function> implémente un algorithme
+ de tri qui traite les chaînes alpha-numériques comme
+ un être humain : c'est ce qui est appelé l'"ordre naturel".
+ </para>
+ <para>
+ <function>natcasesort</function> est la version insensible à la
+ casse de <function>natsort</function>. Voir aussi
+ <function>natsort</function> pour un exemple illustré.
+ </para>
+ <para>
+ Pour plus de détails, rendez vous sur le site de :
+ Martin Pool's
+ <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
+ </para>
+ <para>
+ Voir aussi
+ <function>sort</function>,
+ <function>natsort</function>,
+ <function>strnatcmp</function> et
+ <function>strnatcasecmp</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.next">
+ <refnamediv>
+ <refname>next</refname>
+ <refpurpose>
+ Avance le pointeur interne d'un tableau
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>next</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>next</function> retourne l'élément suivant du tableau,
+ ou <literal>FALSE</literal> si il n'y a plus d'éléments. Le
+pointeur de interne de
+ tableau est avancé d'un élément.
+ </para>
+ <para>
+ <function>next</function> se comporte comme
+ <function>current</function>, mais avec une différence : il avance le
+ pointeur interne de tableau d'un élément avant de retourner la
+ valeur qu'il pointe. Lorsque le pointeur dépasse le dernier
+ élément, <function>next</function> retourne
+<literal>FALSE</literal>.
+ <warning>
+ <para>
+ Si le tableau contient des éléments vides ou des zéros,
+ <function>next</function> retournera <literal>FALSE</literal> pour ces
+éléments.
+ Pour passer proprement en revue un tableau, il faut utiliser
+ <function>each</function>.
</para>
- <para>
- Voir aussi: <function>current</function>,
- <function>each</function>, <function>next</function>,
- <function>prev</function>, et <function>reset</function>.
+ </warning>
+ </para>
+ <para>
+ Voir aussi
+ <function>current</function>,
+ <function>end</function>,
+ <function>prev</function> et
+ <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.pos">
+ <refnamediv>
+ <refname>pos</refname>
+ <refpurpose>Retourne l'élément courant d'un tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>pos</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ <function>pos</function> est une fonction alias de <function>current</function>.
+ </simpara>
+ <para>
+ Voir aussi
+ <function>end</function>,
+ <function>next</function>,
+ <function>prev</function> et
+ <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.prev">
+ <refnamediv>
+ <refname>prev</refname>
+ <refpurpose>Recule le pointeur courant de tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>prev</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>prev</function> repositionne le pointeur interne de tableau à
+ la dernière place qu'il occupait, ou bien retourne
+<literal>FALSE</literal> si il
+ ne reste plus d'éléments.
+ <warning>
+ <para>
+ Si le tableau contient des éléments vides,
+ <function>prev</function> retournera <literal>FALSE</literal> pour ces
+ éléments aussi. Pour passer en revue tous les
+ éléments, utilisez plutôt <function>each</function>.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.rsort">
- <refnamediv>
- <refname>rsort</refname>
- <refpurpose>Trie en ordre inverse</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>rsort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>rsort</function> effectue un trie en ordre décroissant (du plus
grand au
- plus petit).
- <example>
- <title>Exemple avec <function>rsort</function></title>
- <programlisting role="php">
+ </warning>
+ </para>
+ <para>
+ <function>prev</function> se comporte exactement comme
+ <function>next</function>, mais il fait reculer le pointeur plutôt que
+ de l'avancer.
+ </para>
+ <para>
+ Voir aussi
+ <function>current</function>,
+ <function>end</function>
+ <function>next</function> et
+ <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.range">
+ <refnamediv>
+ <refname>range</refname>
+ <refpurpose>
+ Crée un tableau contenant un intervalle d'entiers
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>range</function></funcdef>
+ <paramdef>int <parameter>low</parameter></paramdef>
+ <paramdef>int <parameter>high</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>range</function> retourne un tableau contenant tous les entiers
+ depuis <parameter>low</parameter> jusqu'à <parameter>high</parameter>,
+ inclus.
+ </para>
+ <para>
+ Voir <function>shuffle</function> pour un exemple d'utilisation.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.reset">
+ <refnamediv>
+ <refname>reset</refname>
+ <refpurpose>
+ Remet le pointeur interne de tableau au début
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>reset</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>reset</function> replace le pointeur de tableau
+ <parameter>array</parameter> au premier élément.
+ </para>
+ <para>
+ <function>reset</function> retourne la valeur du premier élément.
+ </para>
+ <para>
+ Voir aussi
+ <function>current</function>,
+ <function>each</function>,
+ <function>next</function>,
+ <function>prev</function> et
+ <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.rsort">
+ <refnamediv>
+ <refname>rsort</refname>
+ <refpurpose>Trie en ordre inverse</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>rsort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>rsort</function> effectue un trie en ordre décroissant (du plus
+grand au
+ plus petit).
+ <example>
+ <title>Exemple avec <function>rsort</function></title>
+ <programlisting role="php">
<?php
$fruits = array("papaye","orange","banane","ananas");
rsort($fruits);
@@ -2723,44 +2781,47 @@
echo "fruits[$key] = ", $value, "\n";
}
?>
- </programlisting>
- </example>
- Cet exemple va afficher:
- <computeroutput>
-fruits[0] = papaye
-fruits[1] = orange
-fruits[2] = banane
-fruits[3] = ananas
- </computeroutput>
- Les fruits ont été classés dans l'ordre alphabétique
- inverse.
- </para>
- <para>
- Voir aussi: <function>arsort</function>,
- <function>asort</function>, <function>ksort</function>,
- <function>sort</function>, et <function>usort</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.shuffle">
- <refnamediv>
- <refname>shuffle</refname>
- <refpurpose>Mélange les éléments d'un tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>shuffle</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>shuffle</function> mélange les éléments
- d'un tableau.
- <example>
- <title>Exemple avec <function>shuffle</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ Cet exemple va afficher:
+ <computeroutput>
+ fruits[0] = papaye
+ fruits[1] = orange
+ fruits[2] = banane
+ fruits[3] = ananas
+ </computeroutput>
+ Les fruits ont été classés dans l'ordre alphabétique
+ inverse.
+ </para>
+ <para>
+ Voir aussi
+ <function>arsort</function>,
+ <function>asort</function>,
+ <function>ksort</function>,
+ <function>sort</function> et
+ <function>usort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.shuffle">
+ <refnamediv>
+ <refname>shuffle</refname>
+ <refpurpose>Mélange les éléments d'un tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>shuffle</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>shuffle</function> mélange les éléments
+ d'un tableau.
+ <example>
+ <title>Exemple avec <function>shuffle</function></title>
+ <programlisting role="php">
<?php
$numbers = range (1,20);
srand (time());
@@ -2769,56 +2830,61 @@
echo "$number ";
}
?>
- </programlisting>
- </example>
- </para>
- <para>
- Voir aussi <function>arsort</function>, <function>asort</function>,
- <function>ksort</function>, <function>rsort</function>,
- <function>sort</function> et <function>usort</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.sizeof">
- <refnamediv>
- <refname>sizeof</refname>
- <refpurpose>Retourne le nombre d'élément d'un tableau</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>sizeof</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>sizeof</function> retourne le nombre d'élément d'un
tableau.
- </para>
- <para>
- Voir aussi: <function>count</function>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.sort">
- <refnamediv>
- <refname>sort</refname>
- <refpurpose>Trie le tableau </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>sort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>sort</function> trie le tableau <parameter>array</parameter>. Les
- éléments seront triés du plus petit au plus grand.
- <example>
- <title>Exemple avec <function>sort</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Voir aussi
+ <function>arsort</function>,
+ <function>asort</function>,
+ <function>ksort</function>,
+ <function>rsort</function>,
+ <function>sort</function> et
+ <function>usort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.sizeof">
+ <refnamediv>
+ <refname>sizeof</refname>
+ <refpurpose>Retourne le nombre d'élément d'un tableau</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>sizeof</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>sizeof</function> retourne le nombre d'élément d'un
+tableau.
+ </para>
+ <para>
+ Voir aussi
+ <function>count</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.sort">
+ <refnamediv>
+ <refname>sort</refname>
+ <refpurpose>Trie le tableau </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>sort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>sort</function> trie le tableau <parameter>array</parameter>. Les
+ éléments seront triés du plus petit au plus grand.
+ <example>
+ <title>Exemple avec <function>sort</function></title>
+ <programlisting role="php">
<?php
$fruits = array("papaye","orange","banane","ananas");
sort($fruits);
@@ -2827,72 +2893,75 @@
}
?>
</programlisting>
- </example>
- Cet exemple va afficher :
- <computeroutput>
-fruits[0] = ananas
-fruits[1] = banane
-fruits[2] = orange
-fruits[3] = papaye
- </computeroutput>
- Les fruits ont été classé dans l'ordre alphabétique.
- </para>
- <para>
- Voir aussi: <function>arsort</function>,
- <function>asort</function>, <function>ksort</function>,
- <function>rsort</function>, et <function>usort</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.uasort">
- <refnamediv>
- <refname>uasort</refname>
- <refpurpose>
- Trie un tableau en utilisant une fonction de comparaison définie par
- l'utilisateur.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>uasort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>function <parameter>cmp_function</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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
- associatifs oú l'ordre des éléments est significatif. La
- fonction de comparaison utilisée est définie par l'utilisateur.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.uksort">
- <refnamediv>
- <refname>uksort</refname>
- <refpurpose>
- Trie les clés d'un tableau en utilisant une fonction de comparaison
définie par l'utilisateur
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>uksort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>function <parameter>cmp_function</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>uksort</function> trie les clés du tableau en utilisant une
- fonction définie par l'utilisateur. Si un tableau qui doit être
- trié avec un critère complexe, il est préférable
- d'utiliser <function>uksort</function>.
- <example>
- <title>Exemple avec <function>uksort</function></title>
- <programlisting role="php">
+ </example>
+ Cet exemple va afficher :
+ <computeroutput>
+ fruits[0] = ananas
+ fruits[1] = banane
+ fruits[2] = orange
+ fruits[3] = papaye
+ </computeroutput>
+ Les fruits ont été classé dans l'ordre alphabétique.
+ </para>
+ <para>
+ Voir aussi
+ <function>arsort</function>,
+ <function>asort</function>,
+ <function>ksort</function>,
+ <function>rsort</function> et
+ <function>usort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.uasort">
+ <refnamediv>
+ <refname>uasort</refname>
+ <refpurpose>
+ Trie un tableau en utilisant une fonction de comparaison définie par
+ l'utilisateur.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>uasort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>function <parameter>cmp_function</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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
+ associatifs ooúugrave; l'ordre des éléments est
+significatif. La
+ fonction de comparaison utilisée est définie par l'utilisateur.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.uksort">
+ <refnamediv>
+ <refname>uksort</refname>
+ <refpurpose>
+ Trie les clés d'un tableau en utilisant une fonction de comparaison
+définie par l'utilisateur
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>uksort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>function <parameter>cmp_function</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>uksort</function> trie les clés du tableau en utilisant une
+ fonction définie par l'utilisateur. Si un tableau qui doit être
+ trié avec un critère complexe, il est préférable
+ d'utiliser <function>uksort</function>.
+ <example>
+ <title>Exemple avec <function>uksort</function></title>
+ <programlisting role="php">
<?php
function mycompare($a, $b) {
if ($a == $b) return 0;
@@ -2904,56 +2973,59 @@
echo "$key: $value\n";
}
?>
- </programlisting>
- </example>
- Cet exemple affichera:
- <computeroutput>
-20: vingt
-10: dix
-4: quatre
-3: trois
- </computeroutput>
- </para>
- <para>
- Voir aussi: <function>arsort</function>,
- <function>asort</function>, <function>uasort</function>,
- <function>ksort</function>, <function>rsort</function>, et
- <function>sort</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.usort">
- <refnamediv>
- <refname>usort</refname>
- <refpurpose>
- Trie les valeurs d'un tableau en utilisant une fonction de comparaison
définie
- par l'utilisateur
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>usort</function></funcdef>
- <paramdef>array <parameter>array</parameter></paramdef>
- <paramdef>function <parameter>cmp_function</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>usort</function> va trier un tableau avec ses valeurs, en utilisant
une fonction
- définie par l'utilisateur. Si un tableau doit être trié
- avec un critère complexe, il est préférable d'utiliser
- cette méthode.
- </para>
- <para>
- La fonction de comparaison <parameter>cmp_function</parameter> doit retourner
un entier,
- qui sera inférieur, égal ou supérieur à zéro
- suivant que le premier argument est considéré comme plus petit,
- égal ou plus grand que le second argument. Si les deux arguments sont
- égaux, leur ordre est indéfini.
- <example>
- <title>Exemple avec <function>usort</function></title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ Cet exemple affichera:
+ <computeroutput>
+ 20: vingt
+ 10: dix
+ 4: quatre
+ 3: trois
+ </computeroutput>
+ </para>
+ <para>
+ Voir aussi
+ <function>arsort</function>,
+ <function>asort</function>,
+ <function>uasort</function>,
+ <function>ksort</function>,
+ <function>rsort</function> et
+ <function>sort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.usort">
+ <refnamediv>
+ <refname>usort</refname>
+ <refpurpose>
+ Trie les valeurs d'un tableau en utilisant une fonction de comparaison
+définie
+ par l'utilisateur
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>usort</function></funcdef>
+ <paramdef>array <parameter>array</parameter></paramdef>
+ <paramdef>function <parameter>cmp_function</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>usort</function> va trier un tableau avec ses valeurs, en utilisant une
+fonction
+ définie par l'utilisateur. Si un tableau doit être trié
+ avec un critère complexe, il est préférable d'utiliser
+ cette méthode.
+ </para>
+ <para>
+ La fonction de comparaison <parameter>cmp_function</parameter> doit retourner un
+entier,
+ qui sera inférieur, égal ou supérieur à zéro
+ suivant que le premier argument est considéré comme plus petit,
+ égal ou plus grand que le second argument. Si les deux arguments sont
+ égaux, leur ordre est indéfini.
+ <example>
+ <title>Exemple avec <function>usort</function></title>
+ <programlisting role="php">
<?php
function cmp($a,$b) {
if ($a == $b) return 0;
@@ -2965,38 +3037,41 @@
echo "$key: $value\n";
}
?>
- </programlisting>
- </example>
- Cet exemple va afficher :
- <computeroutput>
-0: 6
-1: 5
-2: 3
-3: 2
-4: 1
- </computeroutput>
- <note>
- <para>
- Evidemment dans ce cas trivial, <function>rsort</function> serait plus
- approprié.
- </para>
- </note>
- <warning>
- <para>
- Les bibliothèques de tri rapides sur lesquelles reposent PHP
- peuvent le conduire à un plantage, si la fonction de comparaison
- ne retourne pas une valeur cohérente.
- </para>
- </warning>
- </para>
+ </programlisting>
+ </example>
+ Cet exemple va afficher :
+ <computeroutput>
+ 0: 6
+ 1: 5
+ 2: 3
+ 3: 2
+ 4: 1
+ </computeroutput>
+ <note>
+ <para>
+ Evidemment dans ce cas trivial, <function>rsort</function> serait plus
+ approprié.
+ </para>
+ </note>
+ <warning>
<para>
- Voir aussi: <function>arsort</function>,
- <function>asort</function>, <function>ksort</function>,
- <function>rsort</function> et <function>sort</function>.
+ Les bibliothèques de tri rapides sur lesquelles reposent PHP
+ peuvent le conduire à un plantage, si la fonction de comparaison
+ ne retourne pas une valeur cohérente.
</para>
- </refsect1>
- </refentry>
- </reference>
+ </warning>
+ </para>
+ <para>
+ Voir aussi
+ <function>arsort</function>,
+ <function>asort</function>,
+ <function>ksort</function>,
+ <function>rsort</function> et
+ <function>sort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
