each

(PHP 4, PHP 5)

each — Zwraca bieżącą parę klucza i wartości z tablicy i przesuwa kursor tablicy

Opis

array each ( array $tablica )

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.

Przykład #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:

Przykład #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.

Uwaga

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.