(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Устанавливает внутренний указатель массива на его первый элемент
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()
<?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
, можно использовать функцию count() или проверить значение key(), что оно не равноnull
, после вызова reset().