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

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:08