array_walk

array_walk -- Aplica una función del usuario a cada elemento de una matriz.

Descripción

int array_walk ( array matriz, string func, mixed datosvarios)

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( ) .

Nota : 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 .

Nota : El pasar la clave y los datos de usuario a func fue una característica añadida en PHP 4.0 .

En PHP 4 se debe llamar reset( ) las veces necesarias , pues array_walk( ) no reajusta la matriz por defecto .

Ejemplo 1 . Ejemplo de array_walk( )

 
$frutas

 
=

 
array

 
(

 
"d"=

 
"limón"

 
,

 
"a"=

 
"naranja"

 
,

 
"b"=

 
"plátano"

 
,

 
"c"=

 
"manzana")

 
;

 
function

 
test_alterar

 
(

 
$item1

 
,

 
$clave

 
,

 
$prefix

 
)

 
{

 
$item1

 
=

 
"$prefix

 
:

 
$item1"

 
;

 
}

 
function

 
test_ver

 
($item2

 
,

 
$clave

 
)

 
{

 
echo

 
"$clave

 
.

 
$item2

 
br

 
\n"

 
;

 
}

 
array_walk

 
($frutas

 
,

 
'test_ver')

 
;

 
reset

 
($frutas)

 
;

 
array_walk

 
($frutas

 
,

 
'test_alterar'

 
,

 
'fruta')

 
;

 
reset

 
($frutas)

 
;

 
array_walk

 
($frutas

 
,

 
'test_ver')

 
;





Vea también : each( ) y list( ) .