each

each

(PHP 3, PHP 4)

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

Описание

array each (array array)

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

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

$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);

$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);

each() обычно используется в сочетании с list() для прохода по массиву; например, $_POST:

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().