Easy Tutorial
❮ Func Date Interval Format Php Is_Null Function ❯

PHP each() Function

Complete PHP Array Reference Manual

Example

Returns the key and value of the current element and advances the internal pointer:

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

Definition and Usage

The each() function returns the key and value of the current element and advances the internal pointer.

The key and value of the element are returned in an array with four elements. Two elements (1 and Value) contain the value, and two elements (0 and Key) contain the key.

Related methods:


Syntax

Parameter Description
array Required. Specifies the array to use.

Technical Details

Return Value: Returns the key and value of the current element. The key and value of the element are returned in an array with four elements. Two elements (1 and Value) contain the value, and two elements (0 and Key) contain the key. If there are no more array elements, the function returns FALSE.
PHP Version: 4+
--- ---

More Examples

Example 1

Same as the example at the top of the page, but this example outputs the entire array through a loop:

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

reset($people);

while (list($key, $val) = each($people))
{
    echo "$key => $val<br>";
}
?>

Example 2

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

❮ Func Date Interval Format Php Is_Null Function ❯