(PHP 4 >= 4.0.7, PHP 5, PHP 7)
array_key_exists — Проверяет, присутствует ли в массиве указанный ключ или индекс
Функция 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
является свойством объекта, переданным в качестве параметраarray
. На это поведение не стоит полагаться, и перед использованием данной функции необходимо проверять, что параметрarray
имеет тип array.Чтобы проверить, содержит ли объект какое-либо свойство, используйте функцию property_exists().