each

(PHP 4, PHP 5, PHP 7)

each — Повертає поточну пару ключ/значення з масиву та зміщує його покажчик

Увага

Ця функція оголошена застарілої починаючи з PHP 7.2.0 і була ВИДАЛЕНО у версії PHP 8.0.0. Використовувати цю функцію не рекомендується.

Опис

each(array|object &$array): array

Повертає поточну пару ключ/значення з масиву і просуває його покажчик.

Після виконання each(), покажчик масиву переміщається до наступного його елемента, доки досягне кінець масиву. Для повторного обходу масиву за допомогою кожного необхідно використовувати функцію reset()

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

array

Вхідний масив

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

Повертає поточну пару ключ/значення з масиву array. Ця пара повертається до масиву з чотирьох елементів, з ключами keyиvalue. Елементи иkey містять ім'я ключа елемента масиву, а иvalue містять його дані.

Якщо внутрішній покажчик масиву вказує за його межі, each()возвратитfalse

Приклади

Приклад #1 Приклади використання each()

Loading...
▶

$bar тепер містить такі пари ключ/значення:

Array
(
    [1] => bob
    [value] => bob
    [0] => 0
    [key] => 0
)

Loading...
▶

$bar тепер містить такі пари ключ/значення:

Array
(
    [1] => Bob
    [value] => Bob
    [0] => Robert
    [key] => Robert
)

each() зазвичай використовується спільно з list() для обходу масиву, як у цьому прикладі:

Приклад #2 Обхід масиву функцією each()

Loading...
▶

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

a => apple
b => banana
c => cranberry

Застереження

Оскільки додавання елемента в масив скидає покажчик, наведений вище приклад може навести нескінченному циклу, якщо ми присвоюватимемо $fruit інші значення всередині циклу.

Увага

Функцияeach() також приймає об'єкти, але може повернути несподівані результати, тому ітерувати властивості об'єкта за допомогою **each()**не рекомендуется.

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

• key() - Вибирає ключ із масиву
• list() - надає змінним значення схожим на масиви синтаксисом
• current() - Повертає поточний елемент масиву
• reset() - Встановлює внутрішній покажчик масиву на перший елемент
• next() - Переміщує покажчик масиву вперед на один елемент
• prev() - Пересуває внутрішній покажчик масиву на одну позицію назад
• foreach
• Ітерація об'єктів