Vous êtes ici Fonction PHP > Description de la fonction list()

 

Recherche sur les Noms des fonctions php/mysql

 
 

list()

Définition

Transforme une liste de variables en tableau - (PHP 4, PHP 5)

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

<?php

$info = array('coffee', 'brown', 'caffeine');

// Liste toutes les variables
list($drink, $color, $power) = $info;
echo "$drink is $color and $power makes it special.\n";

// Liste certaines variables
list($drink, , $power) = $info;
echo "$drink has $power.\n";

// Ou bien, n'utilisons que le troisième
list( , , $power) = $info;
echo "I need $power!\n";

// list() ne fonctionne pas avec les chaînes de caractères
list($bar) = "abcde";
var_dump($bar); // NULL
?>

Exemple #2 Exemple d'utilisation de list()

<table>
 <tr>
  <th>Employee name</th>
  <th>Salary</th>
 </tr>

<?php

$result = mysql_query("SELECT id, name, salary FROM employees", $conn);
while (list($id, $name, $salary) = mysql_fetch_row($result)) {
    echo " <tr>\n" .
          "  <td><a href=\"info.php?id=$id\">$name</a></td>\n" .
          "  <td>$salary</td>\n" .
          " </tr>\n";
}

?>

</table>

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

<?php

list($a, list($b, $c)) = array(1, array(2, 3));

var_dump($a, $b, $c);

?> 
int(1)
int(2)
int(3)

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

<?php

$info = array('coffee', 'brown', 'caffeine');

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) "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



 
 

Bouts de code utilisant la fonction list()


Afficher les statistiques d'un serveur SHOUTcast

<?php /* ... */ // On place les valeurs de la source dans les noms de variables list($current,$status,$peak,$max,$reported,$bit,$song) = explode(",", $fp_data,  7); /* ... */ ?>
Afficher la jaquette de la musique diffusant sur son SHOUTcast

<?php /* ... */ // Place values from source into variable names list($current,$status,$peak,$max,$reported,$bit,$song) = explode(",", $fp_data,  7); /* ... */ ?>
Astrologie affiche les signes du zodiac

<?php /* ... */    $astrologie_signe = '';    list ( $annee, $mois, $jour ) = explode ( "-", $date );    if     ( ( $mois == 3 && $jour > 20 ) || ( $mois == 4 && $jour < 20 ) ) {  /* ... */ ?>
concaténation d'images pour faire des sprites CSS

<?php /* ... */     foreach ($files as $file) {         list($w, $h, $t) = getimagesize($file);         // vérifie que l'image est de la bonne taille /* ... */ ?>
Création de miniatures carrées à partir d'image de taille variable.

<?php /* ... */ function images_resize_carre($src, $dest, $largeur, $pos){   list($srcX, $srcY, $type, $attr) = getimagesize($src);   $imgSrc=imagecreatefromjpeg($src);  /* ... */ ?>