array_key_exists

(PHP 4 >= 4.0.7, PHP 5, PHP 7)

array_key_exists — Verifica si el índice o clave dada existe en el array

Descripción

array_key_exists ( mixed $key , array $array ) : bool

array_key_exists() devuelve TRUE si la key dada existe en el array. La key puede ser cualquier valor posible para índice de un array.

Parámetros

key: Valor para verificar.
array: Un array con las claves para verificar

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Nota:
array_key_exists() buscará las claves en la primera dimensión solamente. Las claves anidadas en arrays multidimensionales no se encontrarán.

Ejemplos

Ejemplo #1 Ejemplo de array_key_exists()


<?php
$search_array = array('first' => 1, 'second' => 4);
if (array_key_exists('first', $search_array)) {
    echo "The 'first' element is in the array";
}
?>

Ejemplo #2 array_key_exists() vs isset()

isset() no retorna TRUE para claves de array que correspondan a un valor NULL, mientras que array_key_exists() si lo hace.


<?php
$search_array = array('first' => null, 'second' => 4);

// returns false
isset($search_array['first']);

// returns true
array_key_exists('first', $search_array);
?>

Notas

Nota:
Por razones de retrocompatilibidad, array_key_exists() también devuelve TRUE si key es una propiedad definida dentro de un objeto dado como array. No debería depender de este comportamiento, y se ha tener cuidado para asegurarse de que array es un array.

Para comprobar si una propiedad existe en un objeto, use property_exists().

Ver también

isset() - Determina si una variable está definida y no es NULL
array_keys() - Devuelve todas las claves de un array o un subconjunto de claves de un array
in_array() - Comprueba si un valor existe en un array
property_exists() - Comprueba si el objeto o la clase tienen una propiedad