array_walk Wendet eine vom Benutzer gelieferte Funktion auf jedes Element eines Arrays an &reftitle.description; boolarray_walk arrayarray callablecallback mixeduserdata&null; 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. &reftitle.parameters; array Das Eingabe-Array. callback Typischerweise akzeptiert callback zwei Parameter. Der Wert von array wird als erster übergeben, und der Schlüssel/Index als zweiter. Wenn callback direkt mit den Werten des Arrays arbeiten soll, spezifizieren Sie den ersten Parameter von callback als Referenz. Dann werden alle Änderungen an diesen Elementen direkt in dem originalen Array durchgeführt. 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. &reftitle.returnvalues; &return.success; &reftitle.errors; Sollte die Funktion callback mehr als die ihr übergebenen Parameter benötigen, wird bei jedem Aufruf von callback durch array_walk eine Fehlermeldung der Stufe E_WARNING generiert. &reftitle.examples; <function>array_walk</function>-Beispiel "Zitrone", "a" => "Orange", "b" => "Banane", "c" => "Apfel"); function test_alter(&$item1, $key, $prefix) { $item1 = "$prefix: $item1"; } function test_print($item2, $key) { echo "$key. $item2
\n"; } echo "Vorher ...:\n"; array_walk($fruits, 'test_print'); array_walk($fruits, 'test_alter', 'Frucht'); echo "... und nachher:\n"; array_walk($fruits, 'test_print'); ?> ]]>
&example.outputs;
&reftitle.seealso; array_walk_recursive iterator_apply list each call_user_func_array array_map &seealso.callback; &foreach;