list()

(PHP 4, PHP 5, PHP 7)

把数组中的值赋给一组变量

说明

像array()一样，这不是真正的函数，而是语言结构。list()可以在单次操作内就为一组变量赋值。

在 PHP 7.1.0 之前的版本，list()仅能用于数字索引的数组，并假定数字索引从 0 开始。Warning

PHP 5 里，list()从最右边的参数开始赋值； PHP 7 里，list()从最左边的参数开始赋值。

如果你用单纯的变量，不用担心这一点。但是如果你用了具有索引的数组，通常你期望得到的结果和在list()中写的一样是从左到右的，但在 PHP 5 里实际上不是，它是以相反顺序赋值的。

通常而言，不建议依赖于操作的顺序，在未来可能会再次发生修改。

在list()执行过程中修改数组（比如使用list($a,$b)=$b）将会产生不可预知的结果。

参数

一个变量。

返回值

返回指定的数组。

更新日志

范例

Example #1list()例子

Example #2list()用法的一个例子

使用嵌套的list()

int(1)
int(2)
int(3)

在list()中使用数组索引

产生如下输出（注意单元顺序和list()语法中所写的顺序的比较）：

Output of the above example in PHP 7:

array(3) {
  [0]=>
  string(6) "coffee"
  [1]=>
  string(5) "brown"
  [2]=>
  string(8) "caffeine"
}

Output of the above example in PHP 5:

array(3) {
  [2]=>
  string(8) "caffeine"
  [1]=>
  string(5) "brown"
  [0]=>
  string(6) "coffee"
}

Example #5list()和索引顺序定义

list()使用 array 索引的顺序和它何时定义无关。

In PHP 7.1 we can do the following:

Before, we had to do:

However, you will have to array_merge with an array long enough to ensure there are enough elements (if $parameter is empty, the code above would still error).
An alternate approach would be to use array_pad on the array to ensure its length (if all the defaults you need to add are the same).

The example states the following: