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) . "<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