Manuel PHP

Fonctions sur les tableaux
PHP Manual

list

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

Liste de paramètres

varname

Une variable.

Valeurs de retour

Aucune valeur n'est retournée.

Exemples

Exemple #1 Exemple avec list()

  1. <?php
  2.  
  3. $info = array('coffee', 'brown', 'caffeine');  
  4.  
  5. // Liste toutes les variables
  6. list($drink, $color, $power) = $info;  
  7. echo "$drinkis$colorand$powermakes it special.\n";  
  8.  
  9. // Liste certaines variables
  10. list($drink, , $power) = $info;  
  11. echo "$drinkhas$power.\n";  
  12.  
  13. // Ou bien, n'utilisons que le troisième
  14. list( , , $power) = $info;  
  15. echo "I need$power!\n";  
  16.  
  17. // list() ne fonctionne pas avec les chaînes de caractères
  18. list($bar) = "abcde";  
  19. var_dump($bar); // NULL
  20. ?> 

Exemple #2 Exemple d'utilisation de list()

  1. <table>
  2. <tr>
  3. <th>Employee name</th>
  4. <th>Salary</th>
  5. </tr>
  6.  
  7. <?php
  8.  
  9. $result = mysql_query("SELECT id, name, salary FROM employees", $conn);  
  10. while (list($id, $name, $salary) = mysql_fetch_row($result)) { 
  11.    echo " <tr>\n" . 
  12.       "<td><a href=\"info.php?id=$id\">$name</a></td>\n" . 
  13.       "<td>$salary</td>\n" . 
  14.       " </tr>\n";  
  15. }  
  16.  
  17. ?>
  18.  
  19. </table> 

Exemple #3 Utilisation d'un sous-list()

  1. <?php
  2.  
  3. list($a, list($b, $c)) = array(1, array(2, 3));  
  4.  
  5. var_dump($a, $b, $c);  
  6.  
  7. ?> 
int(1) int(2) int(3)

Exemple #4 Utilisation de list() en tenant compte de l'ordre

  1. <?php
  2.  
  3. $info = array('coffee', 'brown', 'caffeine');  
  4.  
  5. list($a[0], $a[1], $a[2]) = $info;  
  6.  
  7. var_dump($a);  
  8.  
  9. ?> 

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) "caffeine" [1]=> string(5) "brown" [0]=> string(6) "coffee" }

Notes

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.

Note: list() fonctionne uniquement avec des tableaux à indexation numérique, et suppose que l'indexation commence à 0.

Voir aussi

Fonctions sur les tableaux
PHP Manual

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique