array_walkWendet eine vom Benutzer gelieferte Funktion auf jedes Element eines Arrays an
&reftitle.description;
truearray_walkarrayobjectarraycallablecallbackmixedarg&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, muss der erste Parameter von
callback als
Referenz spezifiziert
werden. Dann werden alle Änderungen an diesen Elementen direkt in dem
originalen Array durchgeführt.
Viele interne Funktionen (&zb; strtolower)
erzeugen einen Fehler, 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, &dh; 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 das Verhalten
dieser Funktion nicht definiert und auch nicht vorhersagbar.
arg
Wenn der optionale Parameter arg angegeben ist,
wird er dem Callback callback als dritter
Parameter übergeben.
&reftitle.returnvalues;
&return.true.always;
&reftitle.errors;
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), oder mehr
als 3 Parameter, wenn arg ebenfalls übergeben wird.
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.
&reftitle.changelog;
&Version;&Description;
&return.type.true;
8.0.0
Wenn die callback-Funktion erwartet, dass der
zweite oder dritte Parameter per Referenz übergeben wird, gibt diese
Funktion nun einen Fehler der Stufe E_WARNING
aus.
&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;
array_walk-Beispiel mit einer anonymen Funktion
{$value}\n";
});
?>
]]>
&example.outputs;
a
1 => b
2 => c
]]>
&reftitle.seealso;
array_walk_recursiveiterator_applylisteachcall_user_func_arrayarray_map&foreach;