Функция array-search

array_search

Поддерживаемые версии PHP: (PHP 4 >= 4.0.5, PHP 5, PHP 7)

array_searchОсуществляет поиск данного значения в массиве и возвращает ключ первого найденного элемента в случае удачи

Описание функции

mixed array_search ( mixed $needle , array $haystack [, bool $strict = 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. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

Список изменений

Версия Описание
5.3.0 Вместе со всеми внутренними функциями PHP, начиная с версии 5.3.0, array_search() возвращает NULL, если ей были переданы неверные параметры.

Примеры работы

Пример #1 Пример выполнения array_search()

<?php
$array 
= array(=> 'blue'=> 'red'=> 'green'=> 'red');

$key array_search('green'$array); // $key = 2;
$key array_search('red'$array);   // $key = 1;
?>


Возврат к списку