Manuel PHP
list
(PHP 4, PHP 5)
list — Transforme une liste de variables en tableau
Description
Tout comme array(), list() n'est pas une véritable fonction, mais un élément de langage, qui permet de rassembler les variables varname , ... sous forme de tableau, pour les assigner en une seule ligne.
Note: list() fonctionne uniquement avec des tableaux à indexation numérique, et suppose que l'indexation commence à 0.
Example#1 Exemple avec list()
- <?php
- $info = array('café', 'noir', 'cafeine');
- // Liste de toutes les variables
- list($drink, $color, $power) = $info;
- echo "$drinkest$coloret la$powerle rend particulier.\n";
- // Liste de certaines variables
- list($drink, , $power) = $info;
- echo "$drinkcontient de la$power.\n";
- // Ou bien, n'utilisons que le troisième
- list( , , $power) = $info;
- echo "J'ai besoin de$power!\n";
- // list() ne fonctionne pas avec les chaînes de caractères
- list($bar) = "abcde";
- var_dump($bar); // NULL
- ?>
Example#2 Exemple avec list() et MySQL
- <table>
- <tr>
- <th>Nom de l'employé</th>
- <th>Salaire</th>
- </tr>
- <?php
- $resultat = mysql_query ("SELECT id, nom, salaire FROM employes",$conn);
- while (list ($id, $nom, $salaire) = mysql_fetch_row ($resultat)) {
- echo " <tr>\n".
- "<td><a href=\"info.php?id=$id\">$nom</a></td>\n".
- "<td>$salaire</td>\n".
- " </tr>\n";
- }
- ?>
- </table>
list() assigne les valeurs en commençant par la valeur la plus à droite. Si vous utiliser ces variables, ce ne sera pas un problème. Mais si vous utilisez des tableaux, vous serez surpris de voir que list() les affecte de droite à gauche.
Example#3 Exemple avec list() en tenant compte de l'ordre
- <?php
- $info = array('café', 'noir', 'cafeine');
- list($a[0], $a[1], $a[2]) = $info;
- var_dump($a);
- ?>
Cet exemple donne le résultat suivant (notez l'ordre d'affichage des éléments, en comparaison avec l'ordre dans lequel ils ont été écrits dans la syntaxe de list()) :
array(3) {
[2]=>
string(8) "cafeine"
[1]=>
string(5) "noir"
[0]=>
string(6) "café"
}
