(PHP 4, PHP 5, PHP 7)
each — Liefert das aktuelle Schlüssel-Wert-Paar eines Arrays und rückt den Arrayzeiger vor
Diese Funktion ist seit PHP 7.2.0 als DEPRECATED (veraltet) markiert und wurde in PHP 8.0.0 ENTFERNT. Von der Verwendung dieser Funktion wird dringend abgeraten.
Gibt das aktuelle Schlüssel-Wert-Paar von array zurück und rückt den Arrayzeiger vor.
Nachdem each() ausgeführt wurde, bleibt der Arrayzeiger beim nächsten Element des Arrays oder, am Ende des Arrays angelangt, hinter dem letzten Element. Um das Array erneut mittels each() zu durchlaufen, muss die Funktion reset() aufgerufen werden.
arrayDas Eingabe-Array.
Gibt das aktuelle Schlüssel-Wert-Paar aus dem Array array zurück. Dieses Paar wird als Array mit vier Elementen zurückgegeben, und zwar mit den Schlüsseln 0, 1, key, und value. Die Elemente 0 und key enthalten den Namen des Schlüssels, 1 und value den Wert.
Zeigt der interne Zeiger hinter das Ende der Array-Inhalte, gibt each()false zurück.
Beispiel #1 each()-Beispiele
<?php
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each($foo);
print_r($bar);
?>$bar enthält nun die folgenden Schlüssel-Wert-Paare:
Array ( [1] => bob [value] => bob [0] => 0 [key] => 0 )
<?php
$foo = array("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>$bar enthält nun die folgenden Schlüssel-Wert-Paare:
Array ( [1] => Bob [value] => Bob [0] => Robert [key] => Robert )
each() wird typischerweise in Verbindung mit list() verwendet, um ein Array zu durchlaufen:
Beispiel #2 Durchlaufen eines Arrays mit each()
<?php
$fruit = array('a' => 'Apfel', 'b' => 'Banane', 'c' => 'Preiselbeere');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
a => Apfel b => Banane c => Preiselbeere
Da die Zuweisung eines Arrays zu einer anderen Variable den ursprünglichen Arrayzeiger zurücksetzt, würde unser obiges Beispiel in eine Endlosschleife geraten, hätten wir $fruit innerhalb der Schleife einer anderen Variable zugeordnet.
each() akzeptiert auch Objekte, gibt aber eventuell unerwartete Ergebnisse zurück. Es ist daher nicht empfehlenswert, mit each() über Objekteigenschaften zu iterieren.