array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.array-key-exists.php', 1 => 'array_key_exists', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Fonctions sur les tableaux', ), 'prev' => array ( 0 => 'function.array-is-list.php', 1 => 'array_is_list', ), 'next' => array ( 0 => 'function.array-key-first.php', 1 => 'array_key_first', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/array/functions/array-key-exists.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
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ées dans les tableaux multidimensionnels ne seront pas trouvées
Version | Description |
---|---|
8.0.0 |
Le paramètre key accepte désormais
les arguments de type bool , float , int ,
null , resource , et
string .
|
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é.