each

Manual de PHP
Anterior		Siguiente

Descripción

array each ( array matriz)

Devuelve el par clave/valor actual para la matriz y avanza el cursor de la misma. Esta pareja se devuele en una matriz de 4 elementos, con las claves 0, 1, key, y value. Los elementos 0 y key contienen el nombre de clave del elemento de la matriz, y 1 y value contienen los datos.

Si el puntero interno para la matriz apunta pasado el final del contenido de la matriz, each() devuelve FALSE.

Ejemplo 1. Ejemplos de each()
$chorrada = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); $tonteria = each ($chorrada);
$tonteria contiene ahora los siguientes pares clave/valor:
0 => 0
1 => 'bob'
key => 0
value => 'bob'

$chorrada = array ("Robert" => "Bob", "Seppo" => "Sepi"); $tonteria = each ($chorrada);

$tonteria contiene ahora los siguientes pares clave/valor:
0 => 'Robert'
1 => 'Bob'
key => 'Robert'
value => 'Bob'

each() se usa normalmente de forma conjunta a list() para recorrer una matriz; por ejemplo, $HTTP_POST_VARS:
Ejemplo 2. Recorriendo $HTTP_POST_VARS con each()
echo "Valores enviados con el método POST:<br>"; reset ($HTTP_POST_VARS); while (list ($clave, $val) = each ($HTTP_POST_VARS)) { echo "$clave => $val<br>"; }

Cuando se ha ejecutado each(), el cursor de la matriz quedará en el siguiente elemento de la misma, o en el último si llega al final de ésta.

Vea también: key(), list(), current(), reset(), next(), y prev().