PHP each()Functions

PHP Array ReferenceComplete PHP Array Reference

Examples

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

Run example »

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:

  • current()- Returns the value of the current element in the array.
  • end()- Points the internal pointer to the last element of the array and outputs it.
  • next()- Points the internal pointer to the next element of the array and outputs it.
  • prev()- Points the internal pointer to the previous element of the array and outputs it.
  • reset()- Points the internal pointer to the first element of the array and outputs it.
Tip:The each() function was deprecated in PHP 7.2.0。

Syntax

each(array)

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

The same as the example at the top of the page, but this example outputs the entire array using a loop:

<?php $people = array("Peter", "Joe", "Glenn", "Cleveland"); reset($people); while (list($key, $val) = each($people)) { echo "$key => $val<br>"; } ?>

Run example »

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

Run example »

PHP Array ReferenceComplete PHP Array Reference Other Extensions