eachZwraca bieżącą parę klucza i wartości z tablicy i przesuwa kursor tablicy
&warn.deprecated.function-7-2-0.removed-8-0-0;
&reftitle.description;
arrayeacharrayobjectarray
Zwraca bieżącą parę klucza i wartości z tablicy i przesuwa kursor tablicy.
Po wywołaniu each kursor tablicy znajdzie
się na następnym elemencie tablicy lub poza ostatnim
elementem, jeśli został osiągnięty koniec tablicy. Należy użyć
reset jeśli chcemy przejść po tablicy
raz jeszcze używając each.
&reftitle.parameters;
array
Tablica wejściowa.
&reftitle.returnvalues;
Zwraca bieżącą parę klucza i wartości z tablicy
array. Para ta jest zwracana jako czteroelementowa
tablica, z kluczami 0, 1,
key i value. Elementy
0 i key zawierają nazwę klucza
elementu tablicy, a 1 i value
zawierają wartość elementu tablicy.
Jeśli wewnętrzny wskaźnik tablicy wskazuje na miejsce poza końcem
zawartości tablicy, each zwraca
&false;.
&reftitle.examples;
Przykłady użycia each
]]>
Zmienna $bar zawiera teraz następujące pary klucz/wartość:
bob
[value] => bob
[0] => 0
[key] => 0
)
]]>
"Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
]]>
Zmienna $bar zawiera teraz następujące pary klucz/wartość:
Bob
[value] => Bob
[0] => Robert
[key] => Robert
)
]]>
each jest zazwyczaj używana w połączeniu z
list aby przejść przez tablicę. Oto przykład takiego
zastosowania:
Przechodzenie przez tablicę korzystając z funkcji each
'apple', 'b' => 'banana', 'c' => 'cranberry');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>
]]>
&example.outputs;
apple
b => banana
c => cranberry
]]>
Jako że przypisywanie tablicy do innej zmiennej zeruje wskaźnik
tablicy, powyższy przykład wszedłby w nieskończoną pętlę, jeśli
tablica $fruit zostałaby przypisana do innej zmiennej
wewnątrz pętli.
each przyjmuje także obiekty, ale może zwrócić nieoczekiwane
wyniki. W związku z tym nie zaleca się iterowania po obiektach przy użyciu
each.
&reftitle.seealso;
keylistcurrentresetnextprev&foreach;iteracja po obiektach