reset

(PHP 4, PHP 5, PHP 7)

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

Описание

reset ( array|object &$array ) : mixed

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

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

array

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

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

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

Внимание

Эта функция может возвращать как логическое значение false, так и значение не типа boolean, которое приводится к false. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

Примеры

Пример #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().

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

  • current() - Возвращает текущий элемент массива
  • each() - Возвращает текущую пару ключ/значение из массива и смещает его указатель
  • end() - Устанавливает внутренний указатель массива на его последний элемент
  • next() - Перемещает указатель массива вперед на один элемент
  • prev() - Передвигает внутренний указатель массива на одну позицию назад
  • array_key_first() - Получает первый ключ массива