Проверяет, присутствует ли в массиве указанный ключ или индекс


(PHP 4 >= 4.0.7, PHP 5)

array_key_existsПроверяет, присутствует ли в массиве указанный ключ или индекс

Описание

bool array_key_exists ( mixed $key , array $array )

Функция array_key_exists() возвращает TRUE, если в массиве присутствует указанный ключ key. Параметр key может быть любым значением, которое подходит для индекса массива.

Список параметров

key

Проверяемое значение

array

Массив с проверяемыми ключами

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Примеры

Пример #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);
?>

Примечания

Замечание:

Для обратной совместимости может быть использован следующий устаревший псевдоним: key_exists()

Замечание:

По причинам обратной совместимости array_key_exists() возвращает TRUE, если key является свойством объекта, переданным в качестве параметра array. На это поведение не стоит полагаться, и перед использованием данной функции необходимо проверять, что параметр array имеет тип array.

Чтобы проверить, содержит ли объект какое-либо свойство, используйте функцию property_exists().

Смотрите также

  • isset() - Определяет, была ли установлена переменная значением отличным от NULL
  • array_keys() - Возвращает все или некоторое подмножество ключей массива
  • in_array() - Проверяет, присутствует ли в массиве значение
  • property_exists() - Проверяет, содержит ли объект или класс указанный атрибут