PHP Handbuch
Zurück |  | Weiter

# each

(PHP 3, PHP 4, PHP 5)

each -- Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Array Cursor vor

## Beschreibung

array 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
    )

`<?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 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"; } ?>`

Das oben gezeigte Beispiel erzeugt folgende 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.

Zurück | Zum Anfang | Weiter
current | Nach oben | end