PHP reset() Function

Example

Output the value of the current and next element in an array, then reset the array's internal pointer to the first element in the array:

<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");

echo current($people) . " ";
echo next($people) . " ";

echo reset($people);
?>

Try it Yourself »

Definition and Usage

The reset() function moves the internal pointer to the first element of the array.

Related methods:

current() - returns the value of the current element in an array
end() - moves the internal pointer to, and outputs, the last element in the array
next() - moves the internal pointer to, and outputs, the next element in the array
prev() - moves the internal pointer to, and outputs, the previous element in the array
each() - returns the current element key and value, and moves the internal pointer forward

Syntax

reset(array)

Parameter Values

Parameter	Description
array	Required. Specifies the array to use

Technical Details

Return Value:	Returns the value of the first element in the array on success, or FALSE if the array is empty
PHP Version:	4+

More Examples

Example

A demonstration of all related methods:

<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");

echo current($people) . " "; // The current element is Peter
echo next($people) . " "; // The next element of Peter is Joe
echo current($people) . " "; // Now the current element is Joe
echo prev($people) . " "; // The previous element of Joe is Peter
echo end($people) . " "; // The last element is Cleveland
echo prev($people) . " "; // The previous element of Cleveland is Glenn
echo current($people) . " "; // Now the current element is Glenn
echo reset($people) . " "; // Moves the internal pointer to the first element of the array, which is Peter
echo next($people) . " "; // The next element of Peter is Joe

print_r (each($people)); // Returns the key and value of the current element (now Joe), and moves the internal pointer forward
?>

Try it Yourself »

❮ PHP Array Reference