Curriculum
Course: PHP Basic
Login

Curriculum

PHP Basic

PHP Install

0/1

PHP Casting

0/1

PHP Constants

0/1

PHP Magic Constants

0/1

PHP Operators

0/1

PHP Reference

0/276
Text lesson

each()

Example

Return the current element’s key and value, and advance the internal pointer to the next element.

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

Definition and Usage

The each() function retrieves the current element’s key and value and then advances the internal pointer to the next element.

Note: The each() function is deprecated as of PHP 7.2.

This function returns the current element’s key and value in an array as a sub-array with four elements: two for the value (1 and Value), and two for the key (0 and Key).

Related methods:

  • current() – Returns the value of the current element in an array.
  • end() – Moves the internal pointer to the last element in the array and returns it.
  • next() – Advances the internal pointer to the next element in the array and returns it.
  • prev() – Moves the internal pointer to the previous element in the array and returns it.
  • reset() – Resets the internal pointer to the first element of the array.

Syntax

each(array)

Parameter Values

 

Parameter

Description

array

Required. Specifies the array to use.

Technical Details

Return Value:

Returns the current element’s key and value, packaged in an array with four elements: two for the value (1 and Value), and two for the key (0 and Key). This function returns FALSE if there are no more elements in the array.

PHP Version:

4+

PHP Changelog:

This function has been deprecated since PHP 7.2.

More Examples

Example

The same example as above, but using a loop to output the entire array.

<?php
$people = array(“Peter”“Joe”“Glenn”“Cleveland”);

reset($people);

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

Example

A demonstration of all the 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
?>