eachLiefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und
rückt den Arrayzeiger vor
&reftitle.description;
arrayeacharrayarray
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.
&reftitle.parameters;
array
Das Eingabe-Array.
&reftitle.returnvalues;
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.
&reftitle.examples;
each-Beispiele
]]>
$bar enthält nun die folgenden
Schlüssel-Wert-Paare:
bob
[value] => bob
[0] => 0
[key] => 0
)
]]>
"Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
]]>
$bar enthält nun die folgenden
Schlüssel-Wert-Paare:
Bob
[value] => Bob
[0] => Robert
[key] => Robert
)
]]>
each wird typischerweise in Verbindung mit
list verwendet, um ein Array durchzugehen:
Durchgehen eines Arrays mit each
'Apfel', 'b' => 'Banane', 'c' => 'Preiselbeere');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>
]]>
&example.outputs;
Apfel
b => Banane
c => Preiselbeere
]]>
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.
each akzeptiert ebenfalls Objekte, liefert
aber eventuell unerwartete Ergebnisse zurück. Es wird daher nicht
empfohlen, über Objekteigenschaften mit each
zu iterieren.
&reftitle.seealso;
keylistcurrentresetnextprev&foreach;Objektiteration