(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — Ищет значение в массиве и в случае успешного поиска возвращает ключ первого найденного элемента
Ищет значение needle
в массиве haystack
.
needle
Искомое значение.
Замечание:
Если искомое значение
needle
— строка, функция сравнивает значения с учётом регистра.
haystack
Массив.
strict
Функция array_search() будет искать идентичные элементы в массиве haystack
, если третьему параметру strict
установили значение true
. То есть функция также будет выполнять строгое сравнение типа значения needle
в массиве haystack
, а индекс объекта функция найдёт, если объект окажется тем же экземпляром.
Возвращает ключ значения needle
, если функция нашла значение в массиве, иначе false
.
Функция вернёт первый найденный ключ, если в массиве haystack
значение needle
встречается больше одного раза. Чтобы вернуть ключи всех найденных значений, вызывают функцию array_keys() с необязательным параметром filter_value
.
Функция возвращает как логическое значение false
, так и нелогическое значение, которое приводится к false
. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.
Пример #1 Пример использования функции array_search()
<?php
$array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array); // $key = 1;
?>