Podręcznik PHP
Poprzedni |  | Następny

# array_search

(PHP 4 >= 4.0.5, PHP 5)

array_search -- Przeszukuje tablicę pod kątem podanej wartości i w przypadku sukcesu zwraca odpowiedni klucz

## Opis

mixed array_search ( mixed igła, array stóg_siana [, bool ścisły] )

Przeszukuje stóg_siana w poszukiwaniu parametru igła i zwraca odpowiedni klucz jeśli został on znaleziony lub `FALSE` w przeciwnym przypadku.

> Notatka: Jeśli igła jest ciągiem tekstowym, to porówywanie jest dokonywane z uwzględnieniem wielkości znaków.

> Notatka: Począwszy od PHP 4.2.0, zamiast `FALSE`, array_search() zwraca `NULL` w przypadku niepowodzenia.

Jeśli trzeci parametr ścisły jest ustawiony na `TRUE` to array_search() porówna także typy parametru igła z tymi z parametru stóg_siana.

Jeśli igła zostanie znaleziona w stóg_sianawięcej niż raz, to zwracany zostanie klucz pierwszego pasującego elementu. Aby uzyskać klucze wszystkich pasujących wartości należy zastosować funkcję array_keys() z opcjonalnym parametrem szukana_wartość.

Przykład 1. Przykład użycia array_search()

`<?php $tablica = array(0 => 'niebieski', 1 => 'czerwony', 2 => 'zielony', 3 => 'czerwony'); $klucz = array_search('zielony', $tablica); // $klucz = 2; $klucz = array_search('czerwony', $tablica); // $klucz = 1; ?>`

Ostrzeżenie
Ta funkcja może zwrócić logiczne `FALSE`, ale także zwykłą wartość rozpoznawaną jako `FALSE`, na przykład 0 lub "". Więcej informacji w rozdziale dotyczącym typów logicznych. Użyj operatora === aby sprawdzić wartość zwracaną przez tę funkcję.

Patrz także: array_keys(), array_values(), array_key_exists() i in_array().

Poprzedni | Spis treści | Następny
array_reverse | Początek rozdziału | array_shift