current

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

current — Повертає поточний елемент масиву

Опис

current(array|object $array): mixed

У кожного масиву є внутрішній покажчик з його " поточний " елемент, який ініціалізується першим елементом, доданим масив.

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

array

Масив.

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

Функцияcurrent() просто повертає значення елемента масиву, який вказує його внутрішній покажчик. Вона не переміщає покажчик будь-куди. Якщо внутрішній покажчик знаходиться за межами списку елементів або масив порожній, current() повертає 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 Приклад використання current()** та дружніх функцій**

Loading...

Примітки

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

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

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