Manuel PHP
Précédent |  | Suivant

# list

(PHP 3, PHP 4, PHP 5)

list -- Transforme une liste de variables en tableau

## Description

void list ( mixed varname, mixed ... )

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.

Exemple 1. Exemple avec list()

`<?php $info = array('café', 'noir', 'cafeine'); // Liste de toutes les variables list($drink, $color, $power) = $info; echo "$drink est $color et la $power le rend particulier.\n"; // Liste de certaines variables list($drink, , $power) = $info; echo "$drink contient de la $power.\n"; // Ou bien, n'utilisons que le troisième list( , , $power) = $info; echo "J'ai besoin de $power!\n"; ?>`

Exemple 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>`

Avertissement
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.

Exemple 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é"
    }

Voir aussi each(), array() et extract().

Précédent | Sommaire | Suivant
ksort | Niveau supérieur | natcasesort