each
(PHP 4, PHP 5)
each — Vrátiť akuálny kľúč a pár hodnôt z poľa a posunúť kurzor poľa
Popis
Vracia aktuálny kľúč a pár hodnôt z poľa pole a posúva kurzor poľa. Tento pár sa vracia v štvor-prvkovom poli s kľúčami 0, 1, key a value. Prvky 0 a key obsahujú kľúčový názov prvku poľa a 1 a value obsahujú dáta.
Ak vnútorný ukazovateľ pre pole ukazuje na koniec obsahu poľa, each() vracia FALSE.
Example#1 each() príklady
<?php
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each($foo);
print_r($bar);
?>
$bar teraz obsahuje následujúce páry kľúčov/hodnôt:
Array ( [1] => bob [value] => bob [0] => 0 [key] => 0 )
<?php
$foo = array("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
$bar teraz obsahuje následujúce páry kľúčov/hodnôt:
Array ( [1] => Bob [value] => Bob [0] => Robert [key] => Robert )
each() sa väčšinou používa spolu s list() na preskočenie poľa, tu je príklad:
Example#2 Preskočenie poľa s each()
$ovocie = array('a' => 'jablko', 'b' => 'banan', 'c' => 'brusnica');
reset($ovocie);
while (list($key, $val) = each($ovocie)) {
echo "$key => $val<br />\n";
}
?>
Vypise:
a => jablko b => banan c => brusnica
Po vykonaní funkcie each() bude kurzor poľa ponechaný na ďalšom prvku poľa alebo na poslednom prvku, ak je na konci poľa. Musíte použiť reset(), ak chcete znovu preskočiť pole s použitím each..
Pretože priradenie poľa k inej premennej resetuje pôvodný ukazovateľ poľa, náš príklad hore by spôsobil nekonečnú slučku, nakoľko sme $fruit priradili k inej premennej vo vnútri slučky.
Tiež pozri key(), list(), current(), reset(), next(), prev() a foreach.