PHP Handbuch
ZurückVor

each

(PHP 3, PHP 4 >= 4.0.0)

each --  Liefert das nächste Paar (Schlüssel und Wert) eines Arrays

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, and value. Die Elemente 0 und key enthalten den Namen des Schlüssels, 1 and value den Wert.

Zeigt der interne Zeiger hinter das Ende der Array-Inhalte, gibt each() FALSE zurück.

Beispiel 1. each() Beispiele


$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);

$bar enthält nun die folgenden Schlüssel/Wert Paare:

  • 0 => 0
  • 1 => 'bob'
  • key => 0
  • value => 'bob'

$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);

$bar enthält nun die folgenden Schlüssel/Wert Paare:

  • 0 => 'Robert'
  • 1 => 'Bob'
  • key => 'Robert'
  • value => 'Bob'

each() wird typischerweise in Verbindung mit list() verwendet, um ein Array durchzugehen; zum Beispiel $HTTP_POST_VARS:

Beispiel 2. Durchgehen aller $HTTP_POST_VARS mit each() 


echo "Werte, die mit der POST Methode übertragen wurden:<br>";
reset ($HTTP_POST_VARS);
while (list ($key, $val) = each ($HTTP_POST_VARS)) {
    echo "$key => $val<br>";
}

Nachdem each() ausgeführt wurde, bleibt der Array Cursor beim nächsten Element des Arrays, oder wenn am Ende des Arrays angelangt, bei dem letzten Element.

Siehe auch key(), list(), current(), reset(), next(), und prev().

ZurückAnfangVor
currentHochend