Функция PHP each()

Пример

Возвращает имя и значение текущего элемента и перемещает внутренний указатель вперед:

<?php
$people = array("Bill", "Steve", "Mark", "David");
print_r (each($people));
?>

Запуск примера

Определение и использование

Функция each() возвращает имя и значение текущего элемента и перемещает внутренний указатель вперед.

Имя и значение этого элемента будут возвращены в массив из четырех элементов. Два элемента (1 и Value) содержат значение ключа, два элемента (0 и Key) содержат имя ключа.

Связанные методы:

  • current() - Возвращает значение текущего элемента массива
  • end() - Устанавливает внутренний указатель на последний элемент массива и выводит
  • next() - Устанавливает внутренний указатель на следующий элемент массива и выводит
  • prev() - Устанавливает внутренний указатель на предыдущий элемент массива и выводит
  • reset() - Устанавливает внутренний указатель на первый элемент массива и выводит

Синтаксис

each(array)
Параметры Описание
array Обязателен. Определяет массив, который нужно использовать.

Объяснение

Функция each() генерирует массив из имени и значения текущего элемента, указанного внутренним указателем, и перемещает внутренний указатель вперед.

Возвращаемый массив включает в себя следующие четыре элемента: имя ключа 0, 1, key и value. Элементы 0 и key содержат имя ключа массива, 1 и value содержат данные.

Если внутренний указатель вышел за пределы массива, функция возвращает FALSE.

Технические детали

Возвратное значение:

Возвращает имя и значение текущего элемента. Имя и значение этого элемента возвращаются в массив из четырех элементов.

Два элемента (1 и Value) содержат значение ключа, два элемента (0 и Key) содержат имя ключа.

Если больше элементов массива нет, функция возвращает FALSE.

Версия PHP: 4+

Более примеров

Пример 1

Схож с экземпляром в верхней части страницы, но в данном примере выводится весь массив в цикле:

<?php
$people = array("Bill", "Steve", "Mark", "David");
reset($people);
while (list($key, $val) = each($people))
  {
  echo "$key => $val<br>";
  }
?>

Запуск примера

Пример 2

Демонстрируйте все связанные методы:

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // Текущим элементом является Bill
echo next($people) . "<br>"; // Следующим элементом Bill является Steve
echo current($people) . "<br>"; // Текущим элементом является Steve
echo prev($people) . "<br>"; // Предыдущим элементом Steve является Bill
echo end($people) . "<br>"; // Последним элементом является David
echo prev($people) . "<br>"; // Элементом перед David является Mark
echo current($people) . "<br>"; // Текущим элементом является Mark
echo reset($people) . "<br>"; // Перемещает внутренний указатель к первому элементу массива, то есть Bill
echo next($people) . "<br>"; // Следующим элементом Bill является Steve
print_r (each($people); // Возвращает имя ключа и значение текущего элемента (в настоящее время это Steve), и перемещает внутренний указатель вперед
?>

Запуск примера