(PHP 4 >= 4.0.7, PHP 5, PHP 7)
array_key_exists — Vérifie si une clé existe dans un tableau
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.
key
Valeur à vérifier.
array
Un tableau contenant les clés à vérifier.
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.
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);
?>
Note:
En raison de compatibilité ascendante, la fonction array_key_exists() peut aussi retourner
TRUE
si le paramètrekey
est une propriété définie dans un objet, fourni comme paramètrearray
. Ce comportement ne doit plus être pris en considération, et vous devez vous assure que le paramètrearray
est un tableau.Pour vérifier si une propriété existe dans un objet, utilisez la fonction property_exists().