ARRAY_DIFF_UKEY |
Tableau : Différence déclef |
| PHP 5.1.0+ |
Syntaxe
|
function array_diff_ukey($array1, $array2, $key_compare_func);
|
|
function array_diff_ukey($array1, $array2, [...], $key_compare_func);
|
Paramètres
| Nom |
Description |
| $array1 |
Ce paramètre permet d'indiquer le premier tableau à comparer. |
| $array2 |
Ce paramètre permet d'indiquer le deuxième tableau à comparer. |
| $key_compare_func |
Ce paramètre permet d'indiquer une fonction devant appeler pendant la comparaison. Cette fonction devra retourner -1 (inférieur), 0 (égalité) ou 1 (supérieur). |
Retour
| Valeur |
Description |
| tableau |
Ce type de données permet d'indiquer la liste des clefs et valeurs n'étant pas identique entre les tableaux spécifiés |
Description
Cette fonction permet de demander tous les éléments ne se retrouvant dans tous les tableaux en utilisant une fonction de comparaison utilisateur.
Remarques
- But principal : La fonction array_diff_ukey permet de comparer les clefs uniquement de plusieurs tableaux en utilisant une fonction de comparaison
personnalisée (callback). Elle retourne un tableau contenant les éléments du premier tableau dont les clefs ne sont pas présentes dans les autres tableaux, selon la logique
de comparaison définie par la fonction de rappel.
- Comparaison des clefs uniquement : Contrairement à d'autres fonctions comme array_diff ou array_diff_assoc, array_diff_ukey se concentre uniquement
sur les clés des tableaux, en excluant les valeurs de la comparaison. Cela permet de filtrer les éléments d'un tableau en fonction des différences dans les clefs seulement.
- Fonction de comparaison personnalisée des clefs : La fonction accepte une fonction de rappel définissant comment les clefs doivent être comparées. Cette fonction
prend deux clefs comme arguments et retourne un entier indiquant la relation entre elles (comme strcmp ou toute autre logique de comparaison spécifique aux besoins).
- Comparaison stricte des clefs : La fonction compare les clefs de manière stricte, ce qui signifie que les types de clefs doivent correspondre exactement. Par exemple,
la clef "1" (chaîne de caractères) sera considérée différente de la clef 1 (entier). Cela permet une comparaison précise des types de données.
- Ordre des paramètres : Le premier tableau est celui servant de référence pour la comparaison des clefs, et les autres tableaux sont utilisés pour déterminer quelles
clefs du premier tableau ne se retrouvent pas dans les autres. L'ordre des tableaux dans la fonction affecte le résultat.
- Cas des tableaux vides : Si le premier tableau est vide, la fonction retournera un tableau vide, peu importe le contenu des autres tableaux. De même, si les tableaux
de comparaison sont vides, toutes les clefs du premier tableau seront retournées, puisqu'elles ne figurent dans aucun autre tableau.
- Applications pratiques : Cette fonction est particulièrement utile lorsque l'on souhaite filtrer ou comparer des tableaux associatifs en fonction de leurs clefs
seulement, par exemple, pour vérifier la présence ou l'absence de certaines clés dans des ensembles de données ou des configurations.
- Performance : Bien que la fonction offre une flexibilité grâce à la fonction de comparaison personnalisée, elle peut être moins performante que des comparaisons
de clefs simples. La complexité dépendra de la fonction de rappel utilisée et du nombre de clefs à comparer.
Dernière mise à jour : Dimanche, le 22 mars 2015
