array_search
Ищет значение в массиве и возвращает его ключ.
Доступно с: PHP 4
Синтаксис
array_search(mixed $needle, array $haystack, bool $strict = false): int|string|falseПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $needle | mixed | Искомое значение. |
| $haystack | array | Массив, в котором выполняется поиск. |
| $strict | bool | Если `true`, сравнивается и тип значения. |
Возвращаемое значение
int|string|falseКлюч первого найденного элемента или `false`, если значения нет.
Примеры
Ключ найденного значения:
<?php
var_dump(array_search('b', ['a', 'b', 'c']));Результат:
int(1)Значение не найдено:
<?php
var_dump(array_search('z', ['a', 'b', 'c']));Результат:
bool(false)Примечания
Ключ 0 при нестрогом сравнении выглядит как false, поэтому результат сравнивайте через === false. Если ключ не нужен, проще взять in_array().
См. также
- in_array — Проверяет, есть ли значение в массиве.
- array_keys — Возвращает все ключи массива.
Вопросы и ответы по теме
В учебнике
- Массивы — Списки и ассоциативные массивы в PHP — создание, изменение, перебор и полезные функции.