ARRAY_KEYS |
Tableau : Clef |
| PHP 4.0+ |
Syntaxe
|
function array_keys($input);
|
|
function array_keys($input, $search_value);
|
|
function array_keys($input, $search_value, $strict);
|
Paramètres
| Nom |
Description |
| $input |
Ce paramètre permet d'indiquer la table dans lequel la recherche doit être effectué. |
| $search_value |
Ce paramètre permet d'indiquer la valeur à rechercher. |
| $strict |
Ce paramètre permet d'indiquer s'il faut effectuer une comparaison en mode stricte. La valeur par défaut est false. |
Retour
| Valeur |
Description |
| tableau |
Ces valeurs permettent d'indiquer un tableau de tous les clefs |
Description
Cette fonction permet d'effectuer la recherche de tous les clefs ou les valeurs spécifiées dans un tableau.
Remarques
- Extraction des clefs d'un tableau : La fonction array_keys() permet d'extraire toutes les clefs d'un tableau en retournant un tableau contenant uniquement
les clefs. Cela peut être utile pour manipuler ou analyser la structure d'un tableau sans tenir compte des valeurs associées.
- Filtrage optionnel des clés par valeur : En passant un deuxième argument à array_keys(), il est possible de filtrer les clefs correspondant à une valeur
spécifique. Si cette valeur apparaît plusieurs fois dans le tableau, toutes les clefs correspondantes seront incluses dans le résultat.
- Sensibilité aux types pour la recherche de valeur : Lorsque la recherche d'une clef par valeur est activée, un troisième argument optionnel permet de spécifier si
la comparaison doit être stricte (true) ou non. Une comparaison stricte garantit que les types des valeurs sont pris en compte, ce qui peut éviter des résultats inattendus.
- Conservation de l'ordre des clefs : L'ordre des clefs dans le tableau retourné par array_keys() est le même que dans le tableau original. Cela peut être
important pour maintenir l'ordre logique des éléments si les clefs sont utilisées dans un contexte séquentiel.
- Utilisation avec des tableaux associatifs et numériques : array_keys() fonctionne aussi bien avec des tableaux associatifs qu'avec des tableaux indexés
numériquement. Dans le cas d'un tableau associatif, elle permet d'extraire uniquement les noms des clefs associées.
- Compatibilité avec des clefs non standards : Les clefs d'un tableau en PHP peuvent être des chaînes de caractères ou des entiers. array_keys() gère
les deux types de clefs et les retourne sous leur forme originale, qu'elles soient numériques ou textuelles.
- Applications pratiques : array_keys() est souvent utilisé pour parcourir les structures de tableaux complexes, vérifier l'existence de clefs spécifiques ou
effectuer des opérations comme le tri des clefs d'un tableau ou la validation des structures de données.
- Impact sur les performances avec de grands tableaux : Pour les tableaux volumineux, l'utilisation de array_keys() peut consommer une quantité importante
de mémoire, surtout si le tableau contient un grand nombre de clefs. Lorsqu'un filtre est appliqué, cela peut également ralentir l'opération en raison du processus de
recherche.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 359
Dernière mise à jour : Dimanche, le 22 mars 2015
