eachRetorna o par atual de chave e valor de um array e avança o seu cursor
&warn.deprecated.function-7-2-0.removed-8-0-0;
&reftitle.description;
arrayeacharrayobjectarray
Retorna o par atual de chave e valor de um array e avança o seu
cursor.
Depois da execução de each, o cursor do
array irá apontar para o próximo elemento do array, ou após o último
elemento se ele atingir o final do array. Deve-se utilizar
reset se for desejado percorrer o array
novamente usando a função.
&reftitle.parameters;
array
O array de entrada.
&reftitle.returnvalues;
Retorna o par atual de chave e valor do
array. Este par é retornado em um
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
os dados.
Se o cursor interno do array estiver apontando para além do final do
conteúdo do array, each retorna
&false;.
&reftitle.examples;
Exemplos de each
]]>
$bar agora contém os seguintes pares de chaves e
valores:
bob
[value] => bob
[0] => 0
[key] => 0
)
]]>
"Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
]]>
$bar agora contém os seguintes pares de chaves e
valores:
Bob
[value] => Bob
[0] => Robert
[key] => Robert
)
]]>
each é tipicamente usada em conjunto com
list para percorrer um array, por
exemplo:
Percorrendo um array com each
'amora', 'b' => 'banana', 'c' => 'caju');
reset($fruta);
while (list($chave, $valor) = each($fruta)) {
echo "$chave => $valor\n";
}
?>
]]>
&example.outputs;
amora
b => banana
c => caju
]]>
Pelo fato da atribuição de um array a outra variável redefinir o ponteiro
original do array, o exemplo acima deveria causar um loop sem fim se a
variável $fruta fosse atribuída a outra variável dentro do
loop.
each também aceitará objetos, porém pode retornar resultados
inesperados. Portanto, não é recomendado iterar por propriedades de objeto
com each.
&reftitle.seealso;
keylistcurrentresetnextprev&foreach;Object Iteration