each

(PHP 3, PHP 4 )

each --  Retorna o par chave/valor corrente de um array e avança o seu cursor

Descrição

array each ( array array)

Retorna o par chave/valor corrente de array e avança o seu cursor. Esse par é retornado num array de quatro elementos, com as chaves 0, 1, key, e value. Os elementos 0 e key contêm o nome da chave do elemento do array, e 1 e value contêm o valor.

Se o cursor interno do array estiver apontando para além do final do array, each() retorna FALSE.

Exemplo 1. Exemplos de each()

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

$bar agora contem os seguintes pares de chaves e valores:

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

$bar agora contem os seguintes pares de chaves e valores:

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

each() é tipicamente usada em conjunto com list() para percorrer o array; por exemplo, $HTTP_POST_VARS:

Exemplo 2. Percorrendo $HTTP_POST_VARS usando each()

echo "Valores submetidos pelo m&eacute;todo POST:<br>";
reset ($HTTP_POST_VARS);
while (list ($chave, $valor) = each ($HTTP_POST_VARS)) {
    echo "$chave => $valor<br>";
}

Depois da execução de each(), o cursor interno do array vai apontar para o prócimo elemento do array, ou no último elemento se ele chegar ao final do array. Você deve usar reset() se quiser percorrer o array novamente.

Veja também key(), list(), current(), reset(), next(), e prev().