PHP each() Function: Returns Current Key/Value Pair and Advances Array Pointer

The each() function in PHP returns the current key/value pair of an array and moves the internal array pointer one step forward.

After calling each(), the pointer points to the next element; if the end of the array is reached, the pointer stays on the last element and a subsequent call returns FALSE. To iterate again you must reset the pointer with reset().

Parameter: array &$array – the array to be traversed.

Return value: An array containing four elements: the key (indices 0 and "key") and the value (indices 1 and "value"). If the internal pointer has passed the last element, each() returns FALSE.

Example:

<?php
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each($foo);
print_r($bar);
?>

Output:

Array
(
    [1] => bob
    [value] => bob
    [0] => 0
    [key] => 0
)