Руководство по PHP
Пред. |  | След.

# list

(PHP 3, PHP 4, PHP 5)

list -- Присвоить переменным из списка значения подобно массиву

## Описание

void list ( mixed varname, mixed ... )

Подобно array(), это не функция, а языковая конструкция. list() используется для того, чтобы присвоить списку переменных значения за одну операцию.

> Замечание: list() работает только с массивами, индексами которых являются числа и нумерация которых начинается с 0.

Пример 1. Примеры использования list()

`<?php $info = array('coffee', 'brown', 'caffeine'); // Составить список всех переменных list($drink, $color, $power) = $info; echo "$drink is $color and $power makes it special. "; // Составить список только некоторых из них list($drink, , $power) = $info; echo "$drink has $power. "; // Или только третья list( , , $power) = $info; echo "I need $power! "; ?>`

Пример 2. Пример использования 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> " . " <td><a href=\"info.php?id=$id\">$name</a></td> " . " <td>$salary</td> " . " </tr> "; } ?> </table>`

Внимание
list() присваивает значения начиная с крайнего правого параметра. Если вы используете простые переменные, можете не беспокоиться об этом. Но если вы используете индексные массивы, вы можете ожидать, что в результате выполнения функции list() вы получите тот же порядок элементов, что и в исходном массиве: слева направо; однако это не так. Они будут присвоены в обратном порядке.

Пример 3. Использование list() с индексами массивов

`<?php $info = array('coffee', 'brown', 'caffeine'); list($a[0], $a[1], $a[2]) = $info; var_dump($a); ?>`

Выведет (сравните порядок исходных элементов с порядком, в в котором они были перезаписаны функцией list()):

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

См. также each(), array() и extract().

Пред. | Начало | След.
ksort | Уровень выше | natcasesort