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:

Пример 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() .