(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
array_key_exists — Vérifie si une clé existe dans un tableau
$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.
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ées dans les tableaux multidimensionnels ne seront pas trouvées
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
sikey
est une propriété définie dans un object, fourni comme paramètrearray
. Ce comportement est obsolète à partir de PHP 7.4.0, et a été retiré à partir de PHP 8.0.0.Pour vérifier si une propriété existe dans un objet, property_exists() devrait être utilisé.