list

例1 list() の例
 


$info = array('コーヒー', '茶色', 'カフェイン');

// すべての変数の取得
list($drink, $color, $power) = $info;
echo "$drink の色は $color で、$power が含まれています。\n";

// 一部の変数の取得
list($drink, , $power) = $info;
echo "$drink には $power が含まれています。\n";

// 三番目のみの取得
list( , , $power) = $info;
echo "$power 欲しい!\n";

// list() は文字列では動作しません
list($bar) = "abcde";
var_dump($bar); // NULL

 
例2 list() の使用法の例
 <table> <tr>  <th>社員氏名</th>  <th>給与</th> </tr>

$result = $pdo->query("SELECT id, name, salary FROM employees");
while (list($id, $name, $salary) = $result->fetch(PDO::FETCH_NUM)) {
    echo " \n" .
          "  $name\n" .
          "  $salary\n" .
          " \n";
}


</table> 
例3 ネストした list() の使用法
 


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

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


 
int(1)
int(2)
int(3)
 
例4 配列の添字を使用した list() の例
 


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

list($a[0], $a[1], $a[2]) = $info;

var_dump($a);


 
 次のような出力になります(list() の文法に書かれた 順番と、要素の順番の違いに注意): 
 
上の例の PHP 7 での出力は、このようになります。
 
array(3) {
  [0]=>
  string(6) "coffee"
  [1]=>
  string(5) "brown"
  [2]=>
  string(8) "caffeine"
}
 
上の例の PHP 5 での出力は、このようになります。
 
array(3) {
  [2]=>
  string(8) "caffeine"
  [1]=>
  string(5) "brown"
  [0]=>
  string(6) "coffee"
}
 
例5 list() と添字の定義順
 
 list() が配列の要素をどの順に処理するかは、配列の添字とは無関係です。 
 <?php$foo = array(2 => 'a', 'foo' => 'b', 0 => 'c');$foo[1] = 'd';list($x, $y, $z) = $foo;var_dump($foo, $x, $y, $z); 
 結果は次のようになります (list() 内で要素をどの順で利用しているかに注目しましょう)。 
 
array(4) {
  [2]=>
  string(1) "a"
  ["foo"]=>
  string(1) "b"
  [0]=>
  string(1) "c"
  [1]=>
  string(1) "d"
}
string(1) "c"
string(1) "d"
string(1) "a"
 
例6 list() をキーを指定して使う
 
 PHP 7.1.0 以降では、list() に明示的に キーを含めることができるようになりました。 任意の式も指定可能です。 数値や文字のキーも許されますが、 キーがない要素とある要素を混ぜることは許されません 
 <?php$data = [    ["id" => 1, "name" => 'Tom'],    ["id" => 2, "name" => 'Fred'],];foreach ($data as ["id" => $id, "name" => $name]) {    echo "id: $id, name: $name\n";}echo PHP_EOL;list(1 => $second, 3 => $fourth) = [1, 2, 3, 4];echo "$second, $fourth\n"; 
上の例の出力は以下となります。
 
id: 1, name: Tom
id: 2, name: Fred

2, 4