next() веде себе подібно current(), але з однією відмінністю. Перед тим, як повернути значення елемента масиву, функція пересуває його внутрішній покажчик однією позицію вперед. Інакше кажучи, вона повертає наступний елемент масиву і зрушує його внутрішній покажчик однією позицію.

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

array

Масив (array), що змінюється цією функцією.

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

Повертає значення елемента масиву, що знаходиться на позиції, що йде за позицією внутрішнього покажчика або **false**якщо досягнуть кінець масиву.

Увага

Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.

список змін

Версия	Опис
8.1.0	Виклик функції в об'єкті (object) оголошено застарілим. Або спочатку перетворіть об'єкт (object) на масив (array) за допомогою функції get_mangled_object_vars(), або використовуйте методи, що надаються класом, що реалізує інтерфейс Iterator, наПриклад,ArrayIterator
7.4.0	Примірники класів SPL тепер обробляються як порожні об'єкти, які мають властивостей, замість виклику методу Iterator з тим самим ім'ям, що і ця функція.

Версия

Опис

8.1.0

Виклик функції в об'єкті (object) оголошено застарілим. Або спочатку перетворіть об'єкт (object) на масив (array) за допомогою функції get_mangled_object_vars(), або використовуйте методи, що надаються класом, що реалізує інтерфейс Iterator, наПриклад,ArrayIterator

7.4.0

Примірники класів SPL тепер обробляються як порожні об'єкти, які мають властивостей, замість виклику методу Iterator з тим самим ім'ям, що і ця функція.

Приклади

Приклад #1 Приклад використання next()** та пов'язаних функцій**

Loading...

Примітки

Зауваження: Кінець масиву не відрізняється від елемента масиву типу bool зі значенням false. Для коректного обходу масиву, який може містити false, используйте функциюforeach. Якщо ви хочете використовувати функцію next() і при цьому коректно відстежувати кінець масиву, перевіряйте, що функція key() повертає null

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

current() - Повертає поточний елемент масиву
end() - Встановлює внутрішній покажчик масиву на останній елемент
prev() - Пересуває внутрішній покажчик масиву на одну позицію назад
reset() - Встановлює внутрішній покажчик масиву на перший елемент
each() - Повертає поточну пару ключ/значення з масиву та зміщує його покажчик