(PHP 4, PHP 5)
each — Zwraca bieżącą parę klucza i wartości z tablicy i przesuwa kursor tablicy
Zwraca bieżącą parę klucza i wartości z tablicy tablica i przesuwa wewnętrzny wskaźnik tablicy do przodu o jeden element. 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.
Example #1 Przykłady użycia each()
<?php
$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);
print_r($bar);
?>
$bar zawiera teraz następujące pary klucz/wartość:
Array ( [1] => bob [value] => bob [0] => 0 [key] => 0 )
<?php
$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);
print_r($bar);
?>
$bar zawiera teraz następujące pary klucz/wartość:
Array ( [1] => 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:
Example #2 Przechodzenie przez zmienną korzystając z funkcji each()
<?php
$owoce = array('a' => 'jabłko', 'b' => 'banan', 'c' => 'truskawka');
reset ($owoce);
while (list ($klucz, $wartosc) = each ($owoce)) {
echo "$klucz => $wartosc\n";
}
?>
Powyższy przykład wyświetli:
a => jabłko b => banan c => truskawka
Po wykonaniu each(), wewnętrzny wskaźnik tablicy będzie pozostawiony na następnym elementcie tablicy, lub za ostatnim elementem jeśli dojdzie ona do końca tablicy. Musisz użyć reset() jeśli chcesz przejść przez tablicę jeszcze raz korzystając z funkcji each.
Jako że przypisywanie tablicy do innej zmiennej zeruje wskaźnik tablicy, powyższy przykład wszedłby w nieskończoną pętle, jeśli tablica $owoce zostałaby przypisana do innej zmiennej wewnątrz pętli.
Patrz także: key(), list(), current(), reset(), next(), prev() i foreach.