each
(PHP 4, PHP 5)
each — Retorna o par chave/valor corrente de um array e avança o seu cursor
Descrição
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. 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.
Example#1 Exemplos de each()
<?php
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each($foo);
print_r($bar);
?>
$bar agora contém os seguintes pares de chaves e valores:
Array
(
[1] => bob
[value] => bob
[0] => 0
[key] => 0
)
<?php
$foo = array("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
$bar agora contém os seguintes pares de chaves e valores:
Array
(
[1] => Bob
[value] => Bob
[0] => Robert
[key] => Robert
)
each() é tipicamente usada em conjunto com list() para percorrer um array, por exemplo:
Example#2 Percorrendo um array com each()
<?php
$fruit = array('a' => 'apple', 'b' => 'banana', 'c' => 'cranberry');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>
O exemplo acima irá imprimir:
a => apple b => banana c => cranberry
Depois da execução de each(), o cursor interno do array vai apontar para o próximo elemento do array, ou após o último elemento se ele chegar ao final do array. Você deve usar reset() se quiser percorrer o array novamente.
Because assigning an array to another variable resets the original arrays pointer, our example above would cause an endless loop had we assigned $fruit to another variable inside the loop.
Veja também key(), list(), current(), reset(), next(), prev() e foreach.