array_walkWendet eine vom Benutzer gelieferte Funktion auf jedes Element eines Arrays an
&reftitle.description;
boolarray_walkarrayarraycallablecallbackmixeduserdata&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;
array_walk-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_recursiveiterator_applylisteachcall_user_func_arrayarray_map&seealso.callback;&foreach;