(PHP 4 >= 4.0.5, PHP 5)
array_search — Przeszukuje tablicę pod kątem podanej wartości i w przypadku sukcesu zwraca odpowiedni klucz
Przeszukuje stóg_siana w poszukiwaniu parametru
igła i zwraca odpowiedni klucz jeśli został on
znaleziony lub FALSE w przeciwnym przypadku.
Informacja:
Jeśli
igłajest ciągiem tekstowym, to porówywanie jest dokonywane z uwzględnieniem wielkości znaków.
Informacja:
Począwszy od PHP 4.2.0, zamiast
FALSE, array_search() zwracaNULLw 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;
?>
Ta funkcja może
zwrócić Boolean FALSE, ale może też zwrócić wartość innego typu niż Boolean, która oznacza
wartość FALSE, takie jak 0 lub
"". Aby uzyskać więcej informacji proszę zapoznać się z rozdziałem Typy logiczne.
Można używać operatora ===
do testowania zwracanych wartości przez tę
funkcję.
Patrz także: array_keys(), array_values(), array_key_exists() i in_array().