array_key_exists

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

array_key_existsVerifica 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