PHP Portal » PHP Handbuch » each

Werbung

each


(PHP 4, PHP 5)

eachLiefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Arrayzeiger vor

Beschreibung

array each ( array &$array )

Liefert das aktuelle Schlüssel-Wert-Paare des Arrays array , und erhöht den Arrayzeiger.

Nachdem each() ausgeführt wurde, bleibt der Arrayzeiger 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.

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

PHP Code
1
2
3
$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 Code
1
2
3
$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 durchzugehen:

PHP Code
1
2
3
4
5
$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
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.

Warnung

each() akzeptiert ebenfalls Objekte, liefert aber eventuell unerwartete Ergebnisse zurück. Es wird daher nicht empfohlen, über Objekteigenschaften mit each() zu iterieren.

Siehe auch

  • key() - Liefert einen Schlüssel eines assoziativen 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 Zeiger eines Arrays vor
  • prev() - Verkleinert den internen Zeiger eines Arrays
  • foreach
  • Objektiteration