8.3 Tableaux
8 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
|
8.3.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.
|