Функция reset() — встроенная функция PHP, которая:
перемещает внутренний указатель массива на его первый элемент;
возвращает значение первого элемента массива.

Внутренний указатель — это специальная метка, показывающая, какой элемент массива сейчас считается «текущим».

Синтаксис функции reset() php.


		reset(array &$array): mixed

Параметр функции reset() php.

$array — массив, для которого нужно сбросить внутренний указатель. Передаётся по ссылке (&), то есть функция работает с оригинальным массивом, а не с его копией.

Возвращаемое значение функции reset() php.

значение первого элемента массива (любого типа — mixed);

false, если массив пуст.

Обращаю ваше внимание!

Функция может вернуть значение, которое при нестрогом сравнении (==) будет равно false (например, 0, пустая строка '' или false как значение элемента).

Чтобы избежать ошибок, используйте строгое сравнение (===) при проверке результата.

Когда используют функцию reset() php.

Типичный сценарий — после того, как указатель был сдвинут другими функциями:

next() — сдвигает указатель вперёд;
prev() — сдвигает назад;
each() — возвращает текущую пару «ключ‑значение» и сдвигает указатель;
current() — просто возвращает текущий элемент (без сдвига).

Пример использования функции reset() php.

Рассмотрим простейший пример использования/применения reset() php.

Как обычно: теги php...

Возьмем произвольный ассоциативный массив.

Применим к массиву функцию "next", которая передвинет указатель на следующую ячейку.


		next($array);

И передадим это значение в переменную "$var1", которое будет получено с помощью key.

Далее используем reset :


		reset($array);

И так же передадим это значение в другую переменную "$var", которое будет получено с помощью key.

Код примера функции reset() php.


<?
		$array = [

		 'name' => 'Марат',

		 'age' => 30,

		 'city' => 'Москва'

		]; 

 
		next($array);

		$var1 = key($array); 


		reset($array);

		$var = key($array); 


?>