(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Встановлює внутрішній вказівних масиву на його перший елемент
reset() переміщує внутрішній вказівник масиву
array
до його першого елемента та повертає значення
цього елемента.
array
Вхідний масив.
Повертає значення першого елемента масиву або false
, якщо масив
порожній.
Ця функція може
повертати як логічне false
, так і не логічне значення, яке прирівнюється до
false
. Докладніше про це описано в розділі Логічні типи даних. Для перевірки
значення, яке повертає ця функція, використовується оператор ===.
Версія | Опис |
---|---|
8.1.0 | Виклик цієї функції для об'єктів є застарілим. Краще перетворити object в array, застосувавши get_mangled_object_vars(), або використати методи класу, який імплементує Iterator, наприклад ArrayIterator. |
7.4.0 | Примірники класів SPL тепер розглядаються як порожні об'єкти, які не мають властивостей, замість виклику метода інтерфейсу Iterator з такою ж назвою, як і в цієї функції. |
Приклад #1 Використання reset()
<?php
$array = array('крок перший', 'крок другий', 'крок третій', 'крок четвертий');
// Початково вказівник знаходиться на першому елементі
echo current($array) . "<br />\n"; // "крок перший"
// Пропустимо два кроки
next($array);
next($array);
echo current($array) . "<br />\n"; // "крок третій"
// Перевстановлення вказівника, починається знову з "крок перший"
reset($array);
echo current($array) . "<br />\n"; // "крок перший"
?>
Зауваження: Значення, що повертається для порожнього масиву, таке ж, як для масиву, у якого перший елемент — bool
false
. Щоб точно визначити, що значення першого елемента масиву може бутиfalse
, треба поміряти() масив або перевірити, чи не повертає функція key()null
після виклику reset().