Podręcznik PHP
Poprzedni |  | Następny

# each

(PHP 3, 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.

Poprzedni | Spis treści | Następny
current | Początek rozdziału | end