Функция 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
  • false - по умолчанию

Если установлено в 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);
?>

Запуск примера