each
Liefert das aktuelle Schlüssel-Wert-Paar eines Arrays und rückt den
Arrayzeiger vor
&warn.deprecated.function-7-2-0.removed-8-0-0;
&reftitle.description;
arrayeacharrayobjectarray
Gibt das aktuelle Schlüssel-Wert-Paar von array
zurück und rückt den Arrayzeiger vor.
Nachdem each ausgeführt wurde, bleibt der Arrayzeiger
beim nächsten Element des Arrays oder, am Ende des Arrays angelangt, hinter
dem letzten Element. Um das Array erneut mittels each
zu durchlaufen, muss die Funktion reset aufgerufen
werden.
&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 zu durchlaufen:
Durchlaufen 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 ursprünglichen
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 auch Objekte, gibt aber eventuell
unerwartete Ergebnisse zurück. Es ist daher nicht empfehlenswert, mit
each über Objekteigenschaften zu iterieren.
&reftitle.seealso;
keylistcurrentresetnextprev&foreach;Objekt-Iteration