(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.
|
8.0.0 |
Передача значения с типом object в параметр array больше не поддерживается.
|
7.4.0 |
Передача значения с типом object в параметр array устарела.
Для проверки свойвства вместо этой функции вызвают функцию property_exists().
|
Пример #1 Пример использования функции array_key_exists()
<?php
$searchArray = ['first' => 1, 'second' => 4];
var_dump(array_key_exists('first', $searchArray));
?>
Результат выполнения приведённого примера:
bool(true)
Пример #2 Пример использования функции array_key_exists() с языковой конструкцией isset()
Конструкция языка isset() не возвращает true
для ключей массива,
которые ассоциированы со значением null
,
а функция array_key_exists() — возвращает.
<?php
$searchArray = ['first' => null, 'second' => 4];
var_dump(isset($searchArray['first']));
var_dump(array_key_exists('first', $searchArray));
?>
Результат выполнения приведённого примера:
bool(false) bool(true)