(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
array_key_exists — Проверяет, существует ли в массиве заданный ключ или индекс
Функция array_key_exists() возвращает true
, если заданный ключ (key
) содержится в массиве. В параметр key
разрешено передавать значение, которое допустимо в качестве индекса массива.
key
Проверяемое значение.
array
Массив с проверяемыми ключами.
Возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Замечание:
Функция array_key_exists() ищет ключи только на первом уровне массива. Внутренние ключи в многомерных массивах найдены не будут.
Версия | Описание |
---|---|
8.0.0 | Параметр key теперь принимает в качестве аргументов значения bool , float , int , null , resource и string . |
Пример #1 Пример использования функции array_key_exists()
<?php
$search_array = array('first' => 1, 'second' => 4);
if (array_key_exists('first', $search_array)) {
echo "Массив содержит элемент «first».";
}
?>
Пример #2 Пример использования функции array_key_exists() с языковой конструкцией isset()
Конструкция языка isset() не возвращает true
для ключей массива, которые ассоциированы со значением null
, а функция array_key_exists() — возвращает.
<?php
$search_array = array('first' => null, 'second' => 4);
// Возвращает false
isset($search_array['first']);
// Возвращает true
array_key_exists('first', $search_array);
?>
Замечание:
По причинам обратной совместимости функция array_key_exists() возвращает
true
, если ключ (key
) — это свойство объекта (object), переданного в качестве параметраarray
. Поведение устарело в PHP 7.4.0 и удалено в PHP 8.0.0.Проверить, содержит ли объект заданное свойство, можно функцией property_exists().