array_walk --
Wendet eine Benutzerfunktion an jedem Element eines Arrays an
Beschreibung
int array_walk ( array array, string func [, mixed userdata])
Wendet die mittels func angegebene
Benutzerfunktion für jedes Element von arr
an. func wird der Wert als erster, und der
Schlüssel als zweiter Parameter übergeben. Sofern angegeben, wird
userdata, als dritter Parameter an die
Funktion func übergeben.
func muss eine vom Benutzer definierte
Funktion sein, und nicht eine native PHP Funktion. Deshalb können
Sie array_walk() nicht direkt mit
str2lower() benutzen, sondern müssen erst eine
eigene Funktion damit erstellen, und diese Funktion als Argument
übergeben.
Anmerkung: Anstelle eines Funktionsnamens kann auch
ein Array mit einer Objekt-Referenz und dem Namen einer Methode angegeben werden.
Sollte func mehr als zwei oder drei
Argumente verlangen, wird - abhängig von
userdata - bei jedem Aufruf von
func seitens
array_walk() eine Warnmeldung generiert. Diese
Warnmeldungen können unterdrückt werden, indem man dem
Funktionsaufruf von array_walk() ein '@'
Zeichen voranstellt, oder mittels der Verwendung von
error_reporting().
Anmerkung:
Wenn func mit den Werten des Arrays
direkt arbeiten soll, geben Sie an, dass der erste Parameter von
func als Referenz übergeben werden muss.
Dann werden alle Änderungen an diesen Elementen direkt in dem
selbst durchgeführt.
Die Modifizierung des Arrays aus func
heraus könnte ein unvorhersehbares Verhalten hervorrufen.
Anmerkung:
Die Übergabe des Schlüssels und von
userdata an func
wurde mit PHP 4.0 eingeführt.
In PHP 4 muss reset() aufgerufen werden, da
array_walk() den internen Zeiger nicht
selbsttätig wieder auf das erste Element zurücksetzt.
Von der Benutzerfunktion aus darf das Array selbst nicht geändert
werden, wie zum Beispiel durch Hinzufügen oder Löschen eines
Elementes, oder auch Löschen des Arrays, auf das
array_walk() angewendet wird. Ist das Array
geändert, so ist das Verhalten dieser Funktion undefiniert.
