array_walk_recursive
<<<
array_walk array
>>>

6.2 Tableaux
6 Référence des fonctions
 Manuel PHP

Introduction
Pré-requis
Installation
Configuration à l'exécution
Types de ressources
Constantes pré-définies
Voir aussi
array_change_key_case
array_chunk
array_combine
array_count_values
array_diff_assoc
array_diff_key
array_diff_uassoc
array_diff_ukey
array_diff
array_fill
array_filter
array_flip
array_intersect_assoc
array_intersect_key
array_intersect_uassoc
array_intersect_ukey
array_intersect
array_key_exists
array_keys
array_map
array_merge_recursive
array_merge
array_multisort
array_pad
array_pop
array_product
array_push
array_rand
array_reduce
array_reverse
array_search
array_shift
array_slice
array_splice
array_sum
array_udiff_assoc
array_udiff_uassoc
array_udiff
array_uintersect_assoc
array_uintersect_uassoc
array_uintersect
array_unique
array_unshift
array_values
array_walk_recursive
->array_walk
array
arsort
asort
compact
count
current
each
end
extract
in_array
key
krsort
ksort
list
natcasesort
natsort
next
pos
prev
range
reset
rsort
shuffle
sizeof
sort
uasort
uksort
usort

6.2.53 array_walk() Exécute une fonction sur chacun des éléments d'un tableau

[ Exemples avec array_walk ]   PHP 3 >= 3.0.3, PHP 4, PHP 5

bool  array_walk ( array   array , callback   funcname , mixed   userdata )

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exécute la fonction funcname définie par l'utilisateur sur chaque élément du tableau array . Typiquement, funcname prend deux paramètres. La valeur du paramètre input étant le premier et la clé/index, le second. Si le paramètre optionnel userdata est fourni, il sera passé comme troisième paramètre à la fonction définie par l'utilisateur funcname .

Si function requiert plus de paramètres que ceux donnés, une alerte E_WARNING sera générée à chaque fois que la fonction array_walk appellera funcname . Ces alertes peuvent ne pas être affichées en utilisant l'opérateur d'erreur PHP @ lors de l'appel de la fonction array_walk ou en utilisant error_reporting .

Note

Si funcname doit travailler avec les véritables valeurs du tableau, spécifiez que le premier paramètre de funcname doit être passé par référence. Alors, les éléments seront directement modifiés dans le tableau.

Note

Passer les clés et userdata à funcname a été ajouté en PHP 4.0.0

array_walk n'est pas affecté par le pointeur interne du tableau array . array_walk traversera le tableau en totalité sans se soucier de la position du pointeur.

Les utilisateurs ne peuvent pas modifier le tableau lui-même depuis la fonction de callback. Par exemple, Ajout/Effacement d'éléments, réinitialisation d'éléments, etc. Si le tableau sur lequel array_walk est appliqué est changé, le comportement de la fonction est indéfini et non prévisible.

Exemple avec array_walk

<?php;
$fruits = array ("d"=>"citron", "a"=>"orange", "b"=>"banane", "c"=>"pomme");

function
test_alter(&$item1, $key, $prefix) {
    
$item1 = "$prefix: $item1";
}

function
test_print ($item2, $key) {
    echo
"$key. $item2<br />\n";
}

echo
'Avant... '."\n";
array_walk ($fruits, 'test_print');

array_walk ($fruits, 'test_alter', 'fruit');
echo
'...et après :'."\n";

array_walk ($fruits, 'test_print');
?>

Voir aussi array_walk_recursive , create_function , list , foreach , each , call_user_func_array , array_map et information à propos de callback type.

<< array_walk >>
array_walk_recursive Tableaux array