reset
(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Встановлює внутрішній покажчик масиву на перший елемент
Опис
reset(array|object &$array): mixed
Функцияreset() зрушує внутрішній покажчик масиву array перший елемент і повертає значення першого елемента масиву.
Список параметрів
array
Вхідний масив
Значення, що повертаються
Повертає значення першого елемента масиву, або **false**якщо масив порожній.
Увага
Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
список змін
| Версия | Опис |
|---|---|
| 8.1.0 | Виклик функції в об'єкті (object) оголошено застарілим. Або спочатку перетворіть об'єкт (object) на масив (array) за допомогою функції get_mangled_object_vars(), або використовуйте методи, що надаються класом, що реалізує інтерфейс Iterator, наПриклад,ArrayIterator |
| 7.4.0 | Примірники класів SPL тепер обробляються як порожні об'єкти, які мають властивостей, замість виклику методу Iterator з тим самим ім'ям, що і ця функція. |
Приклади
Приклад #1 Приклад використання функції reset()****
Примітки
Зауваження: Значення, що повертається для порожнього масиву не відрізняється від значення у випадку масиву, значення першого елемента якого дорівнює логічному (bool) значенню
false. . Щоб правильно перевірити значення першого елемента масиву, який містить значенняfalse, спочатку функцією count() перевіряють кількість елементів у масиві або після виклику функції reset() перевіряють, що ключ, який повертається функцією key(), не дорівнює значеннюnull
Дивіться також
- current() - Повертає поточний елемент масиву
- each() - Повертає поточну пару ключ/значення з масиву та зміщує його покажчик
- end() - Встановлює внутрішній покажчик масиву на останній елемент
- next() - Переміщує покажчик масиву вперед на один елемент
- prev() - Пересуває внутрішній покажчик масиву на одну позицію назад
- array_key_first() - Отримує перший ключ масиву