Foreach

foreach

(PHP 4, PHP 5)

El constructor foreach proporciona un modo sencillo de iterar sobre arrays. foreach funciona sólo sobre arrays y objetos, y emitirá un error al intentar usarlo con unavariable de un tipo diferente de datos o una variable no inicializada. Existen dos sintaxis:

foreach (expresión_array as $valor)
sentencias
foreach (expresión_array as $clave => $valor)sentencias
La primera forma recorre el array dado por expresión_array. En cada iteración, el valor del elemento actual se asigna a $valor y el puntero interno del array avanza una posición (así en lapróxima iteración se estará observando el siguiente elemento).

La segunda forma además asigna la clave del elemento actual a la variable $clave en cada iteración.

También es posible personalizarla iteración de objetos.

Nota:

Cuando foreach inicia su ejecución, el puntero interno del array se pone automáticamente en el primer elemento del array. Esto significa que no es necesario llamarla función reset() antes de un bucle foreach.

Ya que foreach depende el puntero de array interno, cambiar éste dentro del bucle puede conducir a un comportamiento inesperado.

Para podermodificar directamente los elementos del array dentro de bucle, se ha de anteponer & a $valor. En este caso el valor será asignado por referencia.


Referenciar $valor sólo es posible si el array iteradopuede ser referenciado (es decir, si es una variable). El siguiente código no funcionará:


Advertencia
La referencia del $valor y el último elemento del array permanecen aún después del bucleforeach. Se recomienda destruirlos con unset().

Nota:

foreach no soporta la capacidad de suprimir mensajes de error usando '@'.

Se puede haber notado que las siguientes construcciones sonfuncionalmente idénticas:


Las siguientes construcciones también son funcionalmente idénticas:


Algunos ejemplos más para demostrar su uso:


Utilizando arrays anidados con list()

(PHP 5 >=...