Описание
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().