ProfiPHPProfiPHP
Категория: Функции для работы с массивами

Функция Array_search

Функция Array_search осуществляет поиск данного значения в массиве и возвращает ключ первого найденного элемента в случае удачи.
mixed array_search( mixed $needle , array $haystack [, bool $strict = false ] )
Параметр Needle являет собой искомое значение.
Замечание: Если параметр needle является строкой, сравнение происходит с учетом регистра.

В параметре Haystack необходимо указать массив, в котором происходит поиск.

Если третий параметр Strict установлен в TRUE, то функция Array_search будет искать идентичные элементы в Haystack. Это означает, что также будут проверяться типы Needle в Haystack, а объекты должны быть одним и тем же экземпляром.

Функция Array_search возвращает ключ для Needle, если он был найден в массиве, иначе FALSE.

Если искомое значение присутствует в массиве более одного раза, будет возвращен первый найденный ключ. Для того, чтобы возвратить ключи для всех найденных значений, используйте функцию Array_keys с необязательным параметром Search_value.

Используйте оператор "===" для проверки значения, возвращаемого этой функцией, поскольку данная функция может возвращать как boolean FALSE, так и не-boolean значение, которое приводится к FALSE. За более подробной информацией обратитесь к разделу Двоичные данные (Boolean).

Пример использования:
$array = array( 0 => 'first', 1 => 'second', 2 => 'third', 3 => 'fourth' );
echo $key = array_search( 'second', $array ); // $key = 1;
echo $key = array_search( 'fourth', $array ); // $key = 3;

Добавить комментарий

Имя:
Текст комментария: