Руководство по PHP
Пред. |  | След.

# array_search

(PHP 4 >= 4.0.5, PHP 5)

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

## Описание

mixed array_search ( mixed needle, array haystack [, bool strict] )

Ищет в haystack значение needle и возвращает ключ, если таковое присутствует в массиве, `FALSE` в противном случае.

> Замечание: Если needle является строкой, производится регистро-зависимое сравнение.

> Замечание: До PHP 4.2.0, array_search() при неудаче возвращала `NULL` вместо `FALSE`.

Если вы передадите значение `TRUE` в качестве необязательного третьего параметра strict, функция array_search() также проверит тип needle в массиве haystack.

Если needle присутствует в haystack более одного раза, будет возвращён первый найденный ключ. Для того, чтобы возвратить ключи для всех найденных значений, используйте функцию array_keys() с необязательным параметром search_value.

Пример 1. Пример использования array_search()

`<?php $array = array(0 => 'blue', 1 => 'red', 2 => 0x000000, 3 => 'green', 4 => 'red'); $key = array_search('red', $array); // $key = 1; $key = array_search('green', $array); // $key = 2; (0x000000 == 0 == 'green') $key = array_search('green', $array, true); // $key = 3; ?>`

Внимание
Эта функция может возвращать как логическое значение `FALSE`, так и не относящееся к логическому типу значение, которое приводится к `FALSE`, например, 0 или "". За более подробной информации обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

См. также array_keys(), array_values(), array_key_exists(), и in_array().

Пред. | Начало | След.
array_reverse | Уровень выше | array_shift