array_walk
Aplica una función del usuario a cada elemento de una matriz.
Descripciónintarray_walkarraymatrizstringfuncmixeddatosvarios
&return.success;
Aplica la función llamada func a cada elemento de
la matriz. La función
func recibirá el valor de la matriz como primer
parámetro y la clave como segundo. Si se proporciona el
parámetro datosvarios será pasado como
tercer parámetro a la función de usuario.
Si func necesita más de dos o 3 argumentos,
dependiendo de datosvarios, se generará un
aviso cada vez que array_walk llama a
func. Estos avisos pueden suprimirse si
se pone
@ antes de la
llamada a array_walk,
o usando la función error_reporting.
Si func precisa trabajar con los valores
reales de la matriz, especifique que el valor del primer parámetro
de func debe pasarse por referencia. Desde ese
instante, los cambios realizados sobre dichos elementos también serán
realizados en la propia matriz.
El pasar la clave y los datos de usuario a func
fue una característica añadida en PHP 4.0.0
array_walk no es afectado por el apuntador interno
del parámetro matriz.
array_walk avanzará por toda la matriz sin
importar la posición del apuntador. Para reinicializar el apuntador,
use reset. en PHP 3, array_walk
reinicializa el apuntador.
No se debe cambiar la matriz desde la llamada a la función, ej.
agregar/borrar elementos, vaciar elementos, etc. si la matriz que está
siendo usada por array_walk cambia, el comportamiento
de esta función será indefinido e impredecible.
Ejemplo de <function>array_walk</function>
"limon", "a"=>"naranja", "b"=>"platano", "c"=>"manzana");
function test_alterar ($item1, $clave, $prefix) {
$item1 = "$prefix: $item1";
}
function test_ver ($item2, $clave) {
echo "$clave. $item2 \n";
}
echo "Antes...:\n";
array_walk ($frutas, 'test_ver');
array_walk ($frutas, 'test_alterar', 'fruta');
echo "...y despues:\n";
array_walk ($frutas, 'test_ver');
?>
]]>
&example.outputs;
Vea también array_walk_recursive,
create_function,
list,
foreach,
each,
call_user_func_array,
array_map,
&seealso.callback;.