(PHP 3, PHP 4 )
Returns the current key and value pair from the array
array and advances the
array cursor. This pair is returned in a four-element array,
with the keys
0,
1,
key, and value. Elements
0 and
key contain the key name of
the array element, and 1 and value contain the data.
If the internal pointer for the array points past the
end of the array contents, each()
returns FALSE.
each() is typically used in
conjunction with list() to traverse an array; for instance,
$_POST:
After each() has executed, the
array cursor will be left on the next element of the array,
or on the last element if it hits the end of the array. You
have to use reset() if you want to traverse the array
again using each.
See also key(), list(),
current(), reset(), next(), prev(), and
foreach.