ARRAY_COUNT_VALUES |
Compte les valeurs d'un tableau |
| PHP 4.0+ |
Syntaxe
|
function array_count_values($input)
|
Paramètres
| Nom |
Description |
| $input |
Ce paramètre permet d'indiquer le tableau à traiter |
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.
Remarques
- But principal : La fonction array_count_values permet de compter le nombre d'occurrences de chaque valeur dans un tableau. Elle retourne un tableau associatif
où les clefs représentent les valeurs uniques et les valeurs associées indiquent leur fréquence.
- Types supportés : Seules les valeurs de types int et string sont comptées. Les autres types, comme float, array, ou object, ne seront
pas inclus dans le résultat. Si de telles valeurs sont présentes dans le tableau, elles seront ignorées silencieusement.
- Clefs générées : Les clefs du tableau retourné sont les valeurs uniques présentes dans le tableau d'entrée, et elles conservent leur type d'origine (int ou
string). Cela signifie qu'il n'y aura pas de conversion implicite entre ces types.
- Cas d'un tableau vide : Si un tableau vide est passé en paramètre, la fonction retourne simplement un tableau vide. Cela peut être vérifié facilement pour éviter
des erreurs dans le code.
- Utilisation pratique : Cette fonction est très utile pour analyser la distribution des données dans un tableau. Par exemple, elle est fréquemment utilisée dans les
statistiques, pour trouver des doublons, ou pour optimiser des recherches.
- Performance : La fonction est efficace pour des tableaux de petite à moyenne taille. Toutefois, pour des tableaux très volumineux, la complexité peut augmenter en
fonction du nombre de valeurs uniques à traiter.
- Pas sensible à la casse : Pour les chaînes de caractères, array_count_values est sensible à la casse. Par exemple, "PHP" et "php" seront considérés comme deux
valeurs distinctes et comptés séparément.
- Erreurs fréquentes : Une erreur courante est d'utiliser cette fonction sur des tableaux multidimensionnels. Elle ne fonctionne que sur des tableaux plats (à une dimension)
et ignore les valeurs n'étant pas scalaires.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 358
Dernière mise à jour : Dimanche, le 22 mars 2015
