ARRAY_DIFF_KEY |
Différente clefs d'un tableau |
PHP 5.1.0+ |
Syntaxe
function array_diff_key($tableau,$tableau[,...])
|
Paramètres
Nom |
Description |
$tableau |
Ce paramètre permet d'indiquer les tableaux à comparer |
Retour
Valeur |
Description |
Tableau |
Ce type de données permet d'indiquer le tableau modifié selon le traitement demandé. Soit un liste de clefs représentant la valeur compter identique à celle-ci dans le tableau à traiter et une valeur représentant la quantité calculer pour la clef indiqué |
Description
Cette fonction permet de retourner un tableau indiquant le nombre de valeurs identiques dans chacun des cas mais ne se trouvant pas dans les autres tableaux.
Remarques
- But principal : La fonction array_diff_key compare les clefs de plusieurs tableaux et retourne un tableau contenant les éléments du premier tableau dont
les clefs n'existent pas dans les autres tableaux. Contrairement à array_diff et array_diff_assoc, elle ne se soucie pas des valeurs, mais uniquement des clefs.
- Comparaison des clefs uniquement : array_diff_key ne compare que les clefs des tableaux, sans tenir compte des valeurs. Cela permet de filtrer un tableau en
excluant des éléments basés sur leurs clefs uniquement, indépendamment de leurs valeurs associées.
- Clefs exactes : La comparaison des clés est stricte, ce qui signifie que le type des clés doit correspondre exactement. Par exemple, une clef "1" (chaîne de caractères)
sera considérée différente d'une clef 1 (entier). Cela peut être un comportement important à prendre en compte lorsque l'on travaille avec des tableaux où les types de clefs peuvent
varier.
- Ordre des paramètres : Comme pour d'autres fonctions de comparaison de tableaux, l'ordre des tableaux passés en paramètres est important. Le premier tableau est celui
de référence, et les autres sont utilisés pour exclure les éléments ayant des clefs correspondantes.
- Cas des tableaux vides : Si le premier tableau est vide, array_diff_key retournera également un tableau vide, peu importe le contenu des autres tableaux. Si
les tableaux de comparaison sont vides, toutes les clés du premier tableau seront retournées, puisqu'elles n'existent dans aucun autre tableau.
- Clefs uniques ou doublons : La fonction retourne un tableau contenant uniquement les éléments dont les clefs n'apparaissent pas dans les autres tableaux. Cela signifie
que si un tableau de comparaison contient des clefs en doublon, elles n'affecteront pas le résultat.
- Utilisation avec des tableaux associatifs : array_diff_key est particulièrement utile pour les tableaux associatifs, car elle permet de comparer les clefs (par
exemple, pour détecter des différences dans des ensembles de données ou des configurations).
- Applications pratiques : Un cas d'utilisation courant de array_diff_key est la gestion des configurations. Par exemple, si l'on souhaite vérifier les clefs de
configuration manquantes ou en trop dans différents fichiers de configuration, cette fonction est très pratique pour effectuer une telle comparaison.
Dernière mise à jour : Dimanche, le 22 mars 2015