PHP array_search()Функции
Полное руководство по массивам PHP
Примеры
Найдите в массиве значение "red" и верните имя его ключа:
<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
Запустить пример »
Определение и использование
Функция array_search() используется для поиска значения в массиве и возврата соответствующего имени ключа. Если значение не найдено, она возвращает false.
Синтаксис
array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false
| Параметр | Описание |
|---|---|
| $needle | Обязательный. Задает значение, которое нужно найти в массиве. |
| $haystack | Обязательный. Указывает массив, в котором выполняется поиск. |
| $strict | Необязательный. По умолчанию — false. Сравнивает только значения, а не типы. Если для этого параметра задано значение TRUE, функция ищет в массиве элементы, у которых совпадают и тип данных, и значение. Возможные значения:
|
Технические детали
| Возвращаемое значение: | Если указанное значение найдено в массиве, возвращается соответствующее имя ключа; в противном случае возвращается FALSE. Если значение встречается в массиве более одного раза, возвращается имя ключа, соответствующее первому найденному значению. |
|---|---|
| Версия PHP: | 4.0.5+ |
| Список изменений: | Если в функцию передан недопустимый параметр, функция возвращает NULL (это относится ко всем функциям PHP начиная с PHP 5.3.0). Начиная с PHP 4.2.0, если поиск завершается неудачно, функция возвращает FALSE вместо NULL. |
Другие примеры
Примеры
<?php
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers); // Строгий режим не включён, возвращает имя ключа 1
$key_strict = array_search(2, $numbers, true); // Строгий режим включён, возвращает false
?>
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers); // Строгий режим не включён, возвращает имя ключа 1
$key_strict = array_search(2, $numbers, true); // Строгий режим включён, возвращает false
?>
Пример 1
Найдите в массиве значение 5 и верните его ключ (обратите внимание на ""):
<?php
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>
Запустить пример »
Полное справочное руководство по массивам PHP Другие расширения