each
(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 DEPRECATED (veraltet) und seit PHP 8.0.0 ENTFERNT. Von der Verwendung dieser Funktion wird dringend abgeraten.
Beschreibung
&$array): array
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.
Parameter-Liste
-
array -
Das Eingabe-Array.
Rückgabewerte
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.
Beispiele
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.
Siehe auch
- key() - Liefert einen Schlüssel eines Arrays
- list() - Weist Variablen zu, als wären sie ein Array
- current() - Liefert das aktuelle Element eines Arrays
- reset() - Setzt den internen Zeiger eines Arrays auf sein erstes Element
- next() - Rückt den internen Arrayzeiger vor
- prev() - Setzt den internen Arrayzeiger um ein Element zurück
- foreach
- Objekt-Iteration
