array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.reset.php', 1 => 'reset', 2 => 'Устанавливает внутренний указатель массива на первый элемент', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.range.php', 1 => 'range', ), 'next' => array ( 0 => 'function.rsort.php', 1 => 'rsort', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/reset.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

reset

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

reset — Устанавливает внутренний указатель массива на первый элемент

Описание

reset(array|object &$array): mixed

Функция reset() сдвигает внутренний указатель массива array на первый элемент и возвращает значение первого элемента массива.

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

array

Входной массив.

Возвращаемые значения

Возвращает значение первого элемента массива или false, если массив пуст.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Список изменений

Версия Описание
8.1.0 Вызов функции на значении с типом object устарел. Объект (object) либо сначала преобразовывают в массив (array) функцией get_mangled_object_vars(), либо пользуются методами класса наподобие ArrayIterator, в котором реализовали интерфейс Iterator.
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() проверяют количество элементов в массиве или после вызова функции reset() проверяют, что ключ, возвращаемый функцией key(), не равен значению null.

Смотрите также