list() 不是函數,而是 語言結構,用於將陣列元素一次賦值給多個變數。僅支援數值索引陣列(0 起始),PHP 7.1+ 支援指定鍵名。
list($var1, $var2, ...) = $array;
$array = ['aa', 'ba', 'ca', 'da', 'ea', 'fa'];
list($a, $b, $c) = $array;
echo $a, $b, $c; // 輸出:aabacaaa(註:原文輸出有誤,實際為 aabaca)
正確輸出:aabaca(無分隔符直接連接)。
$a = list($a, $b, $c) = $array;
print_r($a);
/* 輸出:
Array
(
[0] => aa
[1] => ba
[2] => ca
[3] => da
[4] => ea
[5] => fa
) */
此處 $a 接收整個陣列(list() 回傳被賦值的陣列)。
$b = list($a, , $c) = $array; // 略過索引 1
echo $a . ' and ' . $c; // aa and ca
$data = ['id' => 1, 'name' => 'Tom', 'email' => 'tom@example.com'];
['id' => $id, 'name' => $name, 'email' => $email] = $data; // 短陣列語法
// 或
list('id' => $id, 'name' => $name, 'email' => $email) = $data;
$nested = [1, [2, 3], 4];
list($a, [$b, $c], $d) = $nested;
// $a=1, $b=2, $c=3, $d=4
list() 忽略字串鍵,若陣列為 ['a'=>1, 'b'=>2],list($x, $y) 會得到 null, null。null 並發出 Notice。list() 不支援引用賦值(list(&$a, &$b) = ... 無效)。list($year, $month, $day) = explode('-', $date); 日期拆解。list($width, $height, $type, $attr) = getimagesize($path); 圖片資訊解構。fetch_row() 回傳數值索引陣列時快速映射欄位。