array_walk

Définition et utilisation

array_walk() applique une fonction définie par l'utilisateur à chaque élément du tableau. Dans une fonction, le nom de clé et la valeur clé du tableau sont des paramètres.

Remarque: Vous pouvez modifier la valeur d'un élément de tableau en spécifiant le premier paramètre dans la fonction définie par l'utilisateur comme référence: & $ valeur (voir exemple 2).

Conseil: Pour fonctionner des tableaux plus profonds (un tableau contient un autre tableau), utilisez array_walk_recursive() .

Exemple

Exemple 1

Appliquer les fonctions définies par l'utilisateur à chaque élément du tableau:

 <? Php
Fonction MyFunction ( $ Value , $ key )
{
ECHO "La clé de clé $ a la valeur $ valeur <br>" ;
}
$ a = array ( "a" => "red" , "b" => "vert" , "c" => "bleu" ) ;
array_walk ( $ a , "myfunction" ) ;
?>

Essayez-le vous-même

Exemple 2

Définir un paramètre:

 <? Php
Fonction MyFunction ( $ valeur , $ key , $ p )
{
Echo " $ key $ p $ valeur <br>" ;
}
$ a = array ( "a" => "red" , "b" => "vert" , "c" => "bleu" ) ;
array_walk ( $ a , "myfunction" , "a la valeur" ) ;
?>

Essayez-le vous-même

Exemple 3

Modifier la valeur d'un élément de tableau (note & $ valeur):

 <? Php
fonction myFunction ( & $ value , $ key )
{
$ value = "jaune" ;
}
$ a = array ( "a" => "red" , "b" => "vert" , "c" => "bleu" ) ;
array_walk ( $ a , "myfunction" ) ;
print_r ( $ a ) ;
?>

Essayez-le vous-même

grammaire

 array_walk ( array , myfunction , userdata ... )

illustrer

array_walk() applique une fonction de rappel à chaque élément du tableau. Renvoie vrai en cas de succès, sinon retournez false.

En règle générale, MyFunction accepte deux paramètres. La valeur du paramètre du tableau est le premier et le nom de clé est le second. Si le paramètre facultatif UserData est fourni, il sera transmis à la fonction de rappel comme troisième paramètre.

Si la fonction MyFunction nécessite plus de paramètres que donnés, une erreur de niveau E_Warning sera générée à chaque fois que Array_Walk () appelle MyFunction . Ces avertissements peuvent être supprimés en ajoutant l'opérateur d'erreur de PHP @ avant array_walk() , ou en utilisant error_reporting() .

Remarque: Si la fonction de rappel doit agir directement sur la valeur dans le tableau, vous pouvez spécifier le premier paramètre de la fonction de rappel comme une valeur de référence: & $. (Voir l'exemple 3)

Remarque: passer le nom de la clé et l'utilisateur dans MyFunction est un nouvel ajout à PHP 4.0.