Учебник РНР
Назад Вперёд

each

(PHP 3, PHP 4)

each - возвращает текущую пару ключ/значение из массива и передвигает указатель массива.

Описание

array each (array array)

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

Если внутренний указатель массива указывает после конца содержимого массива, each() возвращает FALSE.

Пример 1. each()
$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);

$bar теперь содержит следующие пары key/value:

  • 0 => 0
  • 1 => 'bob'
  • key => 0
  • value => 'bob'
$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);

$bar теперь содержит следующие пары key/value:

  • 0 => 'Robert'
  • 1 => 'Bob'
  • key => 'Robert'
  • value => 'Bob'

each() обычно используется в сочетании с list() для прохода по массиву; например, $_POST:
Пример 2. Проход $_POST с each()
echo "Values submitted via POST method:<br />\n";
reset ($_POST);
while (list ($key, $val) = each ($_POST)) {
    echo "$key => $val<br />\n";
}

После выполнения each() курсор массива остановится на следующем элементе массива или на последнем элементе, если это конец массива. Вы должны использовать reset(), если снова хотите пройти по массиву с использованием each.

См. также key(), list(), current(), reset(), next(), prev() и foreach().


Назад Оглавление Вперёд
current Вверх end