Функция array_search() в PHP
Пример
Ищем ключ-значение "red" в массиве и возвращаем его имя ключа:
<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_search("red",$a); ?>
Определение и использование
Функция array_search() ищет определенное значение в массиве и возвращает соответствующее имя ключа.
Подробное описание
Функция array_search() с in_array() Точно так же, ищем ключ-значение в массиве. Если找到了 это значение, возвращается имя ключа соответствующего элемента. Если не нашли, возвращает false.
До PHP 4.2.0 функция в случае неудачи возвращала null, а не false.
Если третий параметр strict Если установлено в true, то возвращается имя ключа соответствующего элемента только в том случае, если тип данных и значение данных совпадают.
Грамматика
array_search(value,array,strict)
Параметры | Описание |
---|---|
value | Обязателен. Определяет значение ключа, которое нужно поискать. |
array | Обязателен. Определяет массив, в котором выполняется поиск. |
strict |
Опционально. Если параметр установлен в TRUE, функция в массиве ищет элементы, которые имеют одинаковые тип данных и значение.
Если установлено в true,则在数组中检查给定值的类型,число 5 и строка 5 различаются (см. пример 2). |
Технические детали
Возвратное значение: |
Если в массиве найдено указанное значение ключа, возвращается соответствующий ключ, в противном случае возвращается FALSE. Если в массиве найдено значение ключа более одного раза, возвращается имя ключа, соответствующее первому найденному значению. |
Версия PHP: | 4.0.5+ |
Журнал обновлений: |
Если передать функции недопустимые параметры, функция возвращает NULL (это относится ко всем функциям PHP с PHP 5.3.0). С PHP 4.2.0 функция в случае неудачи возвращает FALSE, а не NULL. |
Более примеров
Пример 1
Поиск значения 5 в массиве и возврат его индекса (обратите внимание на ""):
<?php $a=array("a"=>"5","b"=>5,"c"=>"5"); echo array_search(5,$a,true); ?>