array_key_exists

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

array_key_existsVérifie si une clé existe dans un tableau

Description

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

array_key_exists() retourne TRUE s'il existe une clé du nom de key dans le tableau array. key peut être n'importe quelle valeur valide d'index de tableau.

Liste de paramètres

key

Valeur à vérifier.

array

Un tableau contenant les clés à vérifier.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Note:

array_key_exists() va rechercher, uniquement, dans les clés de la première dimension. Les clés imbriqués dans les tableaux multi-dimensionnels ne seront pas trouvés.

Exemples

Exemple #1 Exemple avec array_key_exists()

<?php
$search_array 
= array('premier' => 1'second' => 4);
if (
array_key_exists('premier'$search_array)) {
    echo 
"L'élément 'premier' existe dans le tableau";
}
?>

Exemple #2 array_key_exists() et isset()

isset() ne retourne pas TRUE pour les clés de tableaux qui correspondent à une valeur NULL alors que c'est le cas pour array_key_exists().

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

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

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

Notes

Note:

En raison de compatibilité ascendante, la fonction array_key_exists() peut aussi retourner TRUE si le paramètre key est une propriété définie dans un objet, fourni comme paramètre array. Ce comportement ne doit plus être pris en considération, et vous devez vous assure que le paramètre array est un tableau.

Pour vérifier si une propriété existe dans un objet, utilisez la fonction property_exists().

Voir aussi

  • isset() - Détermine si une variable est déclarée et est différente de NULL
  • array_keys() - Retourne toutes les clés ou un ensemble des clés d'un tableau
  • in_array() - Indique si une valeur appartient à un tableau
  • property_exists() - Vérifie si un objet ou une classe possède une propriété