array_walkWendet eine Benutzerfunktion auf jedem Element eines Arrays an
&reftitle.description;
boolarray_walkarrayarraycallbackfuncnamemixeduserdata
Wendet die mittels funcname 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.
funcname
Typischerweise akzeptiert funcname zwei
Parameter. Der Wert von array wird als
erster übergeben, und der Schlüssel/Index als zweiter.
Wenn funcname direkt mit den Werten des
Arrays arbeiten soll, spezifizieren Sie den ersten Parameter
von funcname als Referenz. Dann werden alle
Änderungen an diesen Elementen direkt in dem originalen Array
durchgeführt.
Das array sollte nicht innerhalb der
Callbackfunktion geändert werden, d.h. es sollten keine Elemente
hinzufügt oder gelöscht werden etc. Wenn das Array, auf das
array_walk angewendet wird, geändert wird,
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
funcname übergeben.
&reftitle.returnvalues;
&return.success;
&reftitle.errors;
Sollte die Funktion funcname mehr als die
ihr übergebenen Parameter benötigen, wird bei jedem Aufruf von
funcname durch array_walk
eine Fehlermeldung der Stufe
E_WARNING generiert. Diese Warnmeldungen können unterdrückt
werden, indem man dem Funktionsaufruf von
array_walk den Operator @ voranstellt,
oder error_reporting verwendet.
&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_applycreate_functionlisteachcall_user_func_arrayarray_map&seealso.callback;&foreach;