eachDevuelve cada par clave/valor de un array
&warn.deprecated.function-7-2-0.removed-8-0-0;
&reftitle.description;
arrayeacharrayobjectarrayeach devuelve el par clave/valor actual del array
array y avanza el puntero del array.
Tras cada llamada a each, el puntero del array se
desplaza al siguiente elemento, o más allá del último elemento, cuando se llega
al final. Debe utilizarse reset si se desea recorrer
el array nuevamente con each.
&reftitle.parameters;
array
El array de entrada.
&reftitle.returnvalues;
Devuelve el par clave/valor actual del array
array y avanza el puntero
del array. Este par se devuelve en un array
de 4 elementos, con las claves 0, 1,
key, y value. Los
elementos 0 y key
contienen el nombre de la clave y 1 y
value contienen el valor.
Si el puntero interno del array está más allá del final del array,
each devuelve &false;.
&reftitle.examples;
Ejemplo con each
]]>
$bar contiene ahora las claves/valores siguientes :
bob
[value] => bob
[0] => 0
[key] => 0
)
]]>
"Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
]]>
$bar contiene ahora las claves/valores siguientes :
Bob
[value] => Bob
[0] => Robert
[key] => Robert
)
]]>
each se utiliza típicamente en conjunción
con list para revisar un array.
Por ejemplo :
Recorrer un array con each
'apple', 'b' => 'banana', 'c' => 'cranberry');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>
]]>
&example.outputs;
apple
b => banana
c => cranberry
]]>
Asignar un array a otra variable reinicia el puntero del array original
a cero. Debido a este comportamiento, se podría haber provocado una
iteración infinita en nuestro ejemplo si se hubiera asignado
$fruit a otra variable dentro de nuestro ciclo.
each también acepta objetos, pero puede devolver
un resultado no esperado. Por lo tanto, no se recomienda utilizar esta
función con objetos.
&reftitle.seealso;
keylistcurrentresetnextprev&foreach;Iteración de objetos