(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
array_key_exists — Проверяет, присутствует ли в массиве указанный ключ или индекс
$key
, array $array
): bool
Функция array_key_exists() возвращает true
, если
в массиве присутствует указанный ключ key
.
Параметр key
может быть любым значением,
которое подходит для индекса массива.
key
Проверяемое значение.
array
Массив с проверяемыми ключами.
Возвращает true
в случае успешного выполнения или false
в случае возникновения ошибки.
Замечание:
array_key_exists() ищет ключи только на первом уровне массива. Внутренние ключи в многомерных массивах найдены не будут.
Пример #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().