ARRAY_KEY_EXISTS |
Tableau : Clef existe |
| PHP 4.0.7+ |
Syntaxe
|
function array_key_exists($key, $search);
|
Paramètres
| Nom |
Description |
| $key |
Ce paramètre permet d'indiquer la table dans lequel la recherche doit être effectué. |
| $search |
Ce paramètre permet d'indiquer la clef à rechercher. |
Retour
| Valeur |
Description |
| FALSE |
Cette valeur permet d'indiquer que la clef n'a pas été trouvé dans la table |
| TRUE |
Cette valeur permet d'indiquer que la clef existe dans la table |
Description
Cette fonction permet d'effectuer la recherche d'une clef dans un tableau et d'ainsi indiquer si elle est existe.
Remarques
- Vérification de l'existence d'une clef : La fonction array_key_exists() permet de vérifier si une clef donnée existe dans un tableau. Elle retourne
true si la clef est présente, même si la valeur associée est null, ce qui la différencie d'une vérification simple avec isset().
- Compatibilité avec les clefs nulles : Contrairement à isset(), retournant false si la valeur associée à une clef est null,
array_key_exists() considère uniquement l'existence de la clef et ignore la valeur. Cela garantit une vérification fiable des clefs dans des tableaux contenant des
valeurs nulles.
- Utilisation avec des tableaux associatifs et numériques : La fonction est compatible avec tous les types de tableaux, qu'ils soient associatifs ou indexés numériquement.
Une clef peut être un entier ou une chaîne de caractères, et array_key_exists() les traite sans distinction.
- Limitation avec les objets : Bien que la fonction fonctionne uniquement sur les tableaux, depuis PHP 5.3.0, elle peut également être utilisée avec des
objets implémentant l'interface ArrayAccess. Cependant, pour vérifier les propriétés d'un objet directement, il est préférable d'utiliser property_exists().
- Performances et tableaux volumineux : La recherche d'une clef avec array_key_exists() est rapide pour des tableaux de taille modérée. Toutefois, pour des
tableaux très volumineux, elle peut être légèrement plus lente que isset() en raison de son fonctionnement axé uniquement sur la clef.
- Utilisation dans des conditions complexes : array_key_exists() est souvent utilisé pour valider l'existence de champs ou d'options dans des tableaux avant
d'effectuer des opérations sur leurs valeurs. Par exemple, il peut être utilisé pour éviter des erreurs lorsque des clefs attendues sont absentes.
- Sensibilité des types des clefs : La fonction effectue une vérification stricte de l'existence de la clef telle qu'elle est définie dans le tableau. Une clef
entière 1 sera traitée comme différente d'une clef chaîne de caractères "1", ce qui garantit une distinction claire entre les types.
- Alternative pour les structures de données complexes : array_key_exists() est particulièrement utile dans les applications nécessitant une gestion robuste
des tableaux associatifs ou des tableaux dynamiques, comme la vérification de champs dans les formulaires ou le traitement des configurations.
Dernière mise à jour : Dimanche, le 22 mars 2015
