list

(PHP 4, PHP 5, PHP 7, PHP 8)

list - Надає змінним значення схожим на масиви синтаксисом

Опис

list(mixed $var, mixed ...$vars = ?): array

Як і конструкція array(), це функція, а мовна конструкція. Конструкцією list() користуються, щоб надавати списку змінних значення за одну операцію. Рядки не можна розпакувати, а вирази list() не можна викликати без аргументів.

Зауваження :

До PHP 7.1.0 конструкцияlist() працювала тільки з індексованими масивами та приймала числові індекси починаючи з 0.

Список параметрів

var

Змінна.

vars

Додаткові змінні.

Значення, що повертаються

Повертає привласнений масив.

список змін

Версия	Опис
7.3.0	Додано підтримку присвоєння за посиланнями при деструктуруванні масиву.
7.1.0	Тепер у конструкції list() можна задавати ключі. Це дозволяє розіменовувати асоціативні масиви та масиви з індексами не по порядку.

Приклади

Приклад #1 Приклад використання конструкції list()

Loading...
▶

Приклад #2 Приклад використання конструкції list()

Loading...
▶

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

Loading...
▶

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

Приклад #4 Конструкцияlist()** та порядок вказівки індексів**

Порядок визначення індексів у масиві, з яким працюватиме конструкція list(), не важливий.

Loading...
▶

Дає такий висновок (зверніть увагу на порядок, в якому елементи порівнювалися, і в якому порядку записані елементи в синтаксисі 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"

Приклад #5list()** з ключами**

Починаючи з PHP 7.1.0 конструкції list() можна містити явні ключі, які вказують як довільні вирази. Допустимо змішувати рядкові та цілочислові ключі; однак елементи з ключами і без ключів не можна змішувати.

Loading...
▶

Результат виконання наведеного прикладу:

id: 1, name: Tom
id: 2, name: Fred

2, 4

Дивіться також

• each() - Повертає поточну пару ключ/значення з масиву та зміщує його покажчик
• array() - створює масив
• extract() - Імпортує змінні масиву до поточної таблиці символів