(PHP 4, PHP 5, PHP 7)
array_walk — Wendet eine vom Benutzer gelieferte Funktion auf jedes Element eines Arrays an
Wendet die mittels callback angegebene
Benutzerfunktion auf jedes Element von array
an.
array_walk() ist nicht von dem internen
Arrayzeiger von array betroffen.
array_walk() geht ungeachtet der Zeigerposition
das gesamte Array durch.
arrayDas Eingabe-Array.
callback
Typischerweise akzeptiert callback zwei
Parameter. Der Wert von array wird als
erster übergeben, und der Schlüssel/Index als zweiter.
Hinweis:
Wenn
callbackdirekt mit den Werten des Arrays arbeiten soll, spezifizieren Sie den ersten Parameter voncallbackals Referenz. Dann werden alle Änderungen an diesen Elementen direkt in dem originalen Array durchgeführt.
Hinweis:
Viele interne Funktionen (wie z.B. strtolower()) erzeugen eine Warnung, wenn mehr als die erwartete Anzahl von Parametern übergeben wird; sie sind auch nicht direkt nutzbar als
callback.
Nur die Werte von array können geändert werden.
Die Struktur des Arrays kann nicht geändert werden, d.h. dass der
Programmierer keine Elemente hinzufügen oder löschen kann und dass
die Reihenfolge der Elemente nicht geändert werden kann. Falls die
Callback-Funktion diese Anforderung nicht beachtet, ist der Verhalten
dieser Funktion nicht definiert und auch nicht vorhersagbar.
userdata
Wenn der optionale Parameter userdata
angegeben ist, wird er als dritter Parameter dem Callback
callback übergeben.
Gibt TRUE zurück.
Von PHP 7.1.0 an wird ein ArgumentCountError
ausgelöst, wenn die callback-Funktion mehr als 2
Parameter benötigt (der Wert und Schlüssel des Array-Elements).
Zuvor wurde, falls die callback-Funktion mehr als 2
Parameter benötigte, bei jedem Aufruf von
callback durch array_walk()
eine Fehlermeldung der Stufe
E_WARNING generiert.
Beispiel #1 array_walk()-Beispiel
<?php
$fruits = array("d" => "Zitrone", "a" => "Orange", "b" => "Banane", "c" => "Apfel");
function test_alter(&$item1, $key, $prefix)
{
$item1 = "$prefix: $item1";
}
function test_print($item2, $key)
{
echo "$key. $item2<br>\n";
}
echo "Vorher ...:\n";
array_walk($fruits, 'test_print');
array_walk($fruits, 'test_alter', 'Frucht');
echo "... und nachher:\n";
array_walk($fruits, 'test_print');
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Vorher ...: d. Zitrone a. Orange b. Banane c. Apfel ... und nachher: d. Frucht: Zitrone a. Frucht: Orange b. Frucht: Banane c. Frucht: Apfel