Przeszukuje tablicę pod kątem podanej wartości i w przypadku sukcesu zwraca odpowiedni klucz.
array_search ($igÅ‚a , $stóg_siana [, $Å›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.
Informacja: JeÅ›li igÅ‚a jest 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() 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_siana wiÄ™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ść .
Kompatybilność: PHP4, PHP5.
Listing
$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ę.
Ranga: Administrator serwisu Punktów: 38473

