Funkcja PHP array_search() przeszukuje tablicę w celu znalezienia określonej wartości i zwraca klucz jej pierwszego znalezionego egzemplarza lub wartość logiczną false, jeśli nie znajdzie ani jednego.
Składnia funkcji PHP array_search()
Funkcja PHP array_search() ma następującą składnię:
array_search(mixed $needle, array $haystack, bool $strict = false): int|string|falseParametry
| Parametr | Opis |
|---|---|
| needle | Parametr obowiązkowy. Wartość szukana. W przypadku łańcuchów wielkość liter jest rozróżniana. |
| haystack | Parametr obowiązkowy. Tablica do przeszukania. |
| strict | Ustawienie tego parametru na true powoduje włączenie trybu porównywania ścisłego, czyli aby element został znaleziony, musi być identyczny z szukanym. Inaczej mówiąc, funkcja stosuje taką samą metodę porównywania, jak operator PHP ===. |
Wartość zwrotna
Funkcja PHP array_search() zwraca klucz (albo indeks) znalezionego elementu, jeśli znajdzie szukaną wartość, lub wartość logiczną false w przeciwnym razie.
Jako że funkcja ta może zwracać zarówno wartość logiczną, jak i wartości liczbowe i łańcuchowe, które również mogą zostać zinterpretowane jako logiczne, do sprawdzania jej wartości zwrotnej powinno się używać operatora ===.
