each (PHP 3, PHP 4 ) each --
Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und
rückt den Array Cursor vor.
Beschreibungarray each ( array array)
Liefert das aktuelle Schlüssel- Wertepaar des Arrays
array, und erhöht den Array Cursor. Dieses
Paar wird als Array mit 4 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
) |
|
each() wird typischerweise in Verbindung mit
list() verwendet, um ein Array durchzugehen:
Beispiel 2. Durchgehen 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"; }
/* Ausgabe:
a => Apfel b => Banane c => Preiselbeere
*/ ?>
|
|
Nachdem each() ausgeführt wurde, bleibt der
Array Cursor beim nächsten Element des Arrays, oder wenn am Ende
des Arrays angelangt, nach dem letzten Element. Sie müssen
reset() verwenden, wenn Sie das Array erneut
mittels each durchgehen wollen.
| Achtung |
Da die Zuweisung eines Arrays zu einer anderen Variable den originalen
Arrayzeiger zurücksetzt, würde unser obiges Beispiel in eine Endlosschleife
geraten, hätten wir $fruit innerhalb der Schleife
einer anderen Variable zugeordnet.
|
Siehe auch key(), list(),
current(), reset(),
next(), prev() und
foreach.
|