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