array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — Здійснює пошук даного значення в масиві та повертає ключ першого знайденого елемента у разі успішного виконання
Опис
array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false
Шукає в haystackзначениеneedle
Список параметрів
needle
Шукане значення.
Зауваження :
Якщо
needleє рядком, порівняння відбувається з урахуванням регістру.
haystack
Масив.
strict
Если третий параметрstrictустановлен в**true, то функцияarray_search()** шукатиме ідентичні елементи в haystack. Це означає, що також перевірятимуться типи needleвhaystack, а об'єкти повинні бути одним і тим самим екземпляром.
Значення, що повертаються
Повертає ключ для needleякщо він був знайдений у масиві, інакше false
Якщо needle присутній у haystack більше одного разу буде повернено перший знайдений ключ. Для повернення ключів для всіх знайдених значень використовуйте функцію array_keys() з необов'язковим параметром search_value
Увага
Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
Приклади
Приклад #1 Приклад використання array_search()****
Дивіться також
- array_keys() - Повертає все або деяке підмножина ключів масиву
- array_values() - Повертає всі значення масиву
- array_key_exists() - Перевіряє, чи існує в масиві заданий ключ чи індекс
- in_array() - Перевіряє, чи є у масиві значення