THE WORLD'S LARGEST WEB DEVELOPER SITE

PHP reset() Function

❮ PHP Array Reference

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) . "<br>";
echo next($people) . "<br>";

echo reset($people);
?>
Run example »

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 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 1

A demonstration of all related methods:

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

echo current($people) . "<br>"; // The current element is Peter
echo next($people) . "<br>"; // The next element of Peter is Joe
echo current($people) . "<br>"; // Now the current element is Joe
echo prev($people) . "<br>"; // The previous element of Joe is Peter
echo end($people) . "<br>"; // The last element is Cleveland
echo prev($people) . "<br>"; // The previous element of Cleveland is Glenn
echo current($people) . "<br>"; // Now the current element is Glenn
echo reset($people) . "<br>"; // Moves the internal pointer to the first element of the array, which is Peter
echo next($people) . "<br>"; // 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
?>
Run example »

❮ PHP Array Reference