list
Assign variables as if they were an array
&reftitle.description;
arraylist
mixedvarname
mixed...
Like array, this is not really a function,
but a language construct. list is used to
assign a list of variables in one operation.
&reftitle.parameters;
varname
A variable.
&reftitle.returnvalues;
Returns the assigned array.
&reftitle.examples;
<function>list</function> examples
]]>
An example use of <function>list</function>
| Employee name |
Salary |
query("SELECT id, name, salary FROM employees");
while (list($id, $name, $salary) = $result->fetch(PDO::FETCH_NUM)) {
echo " \n" .
" | $name | \n" .
" $salary | \n" .
"
\n";
}
?>
]]>
Using nested <function>list</function>
]]>
Using <function>list</function> with array indices
]]>
Gives the following output (note the order of the elements compared in
which order they were written in the list syntax):
string(8) "caffeine"
[1]=>
string(5) "brown"
[0]=>
string(6) "coffee"
}
]]>
&reftitle.notes;
list assigns the values starting with the right-most
parameter. If you are using plain variables, you don't have to worry
about this. But if you are using arrays with indices you usually expect
the order of the indices in the array the same you wrote in the
list from left to right; which it isn't. It's
assigned in the reverse order.
Modification of the array during list execution (e.g.
using list($a, $b) = $b) results in undefined behavior.
list only works on numerical arrays and assumes
the numerical indices start at 0.
&reftitle.seealso;
each
array
extract