ArrayAvg |
Moyenne de tableau |
|---|---|
| Lucee | |
Syntaxe
| ArrayAvg( array=array ); |
Paramètres
| Nom | Description |
|---|---|
| array | Ce paramètre permet de spécifier le tableau dont on veut calculer la moyenne. Le tableau doit contenir uniquement des valeurs numériques valides, car toute donnée non numérique provoquerait une erreur ou un résultat incorrect. |
Description
Cette fonction permet de calculer la moyenne des valeurs d'un tableau.
Remarques
- La fonction ArrayAvg() calcule la moyenne arithmétique des éléments d'un tableau. Elle additionne toutes les valeurs numériques présentes, puis divise la somme obtenue par le nombre total d'éléments. Cela en fait un outil simple et efficace pour obtenir une mesure centrale d'un ensemble de données numériques.
- Le paramètre array doit impérativement contenir uniquement des valeurs numériques valides. Si le tableau comporte des chaînes de caractères, des structures ou d'autres types non numériques, Lucee renverra une erreur ou produira un résultat incohérent. Il est donc recommandé de valider le contenu du tableau avant d'appeler cette fonction.
- ArrayAvg() retourne un nombre représentant la moyenne calculée. Ce résultat peut être un entier ou un nombre à virgule flottante selon la nature des données présentes dans le tableau. Par exemple, [1, 2, 3, 4] donnera 2.5, alors que [1, 2, 3, 4, 5] retournera 3.
- Cette fonction ne modifie pas le tableau d'origine : elle se contente d'en lire les valeurs. Cela garantit la sécurité des données initiales et permet d'utiliser la fonction dans des contextes où l'intégrité du tableau doit être conservée, comme dans des calculs statistiques ou des rapports analytiques.
- ArrayAvg() est particulièrement utile dans les opérations de traitement de données numériques, comme le calcul de moyennes de notes, de prix, de températures ou d'autres indicateurs quantitatifs. Elle s'intègre facilement dans des boucles, des scripts analytiques ou des fonctions de reporting.
- Pour éviter les erreurs d'exécution, il est recommandé de vérifier que le tableau n'est pas vide avant d'appeler ArrayAvg(). Si le tableau ne contient aucun élément, la division par zéro peut produire une erreur. Une condition préalable telle que ArrayLen(array) > 0 assure un traitement plus robuste.
- Cette fonction améliore la lisibilité du code par rapport à un calcul manuel de moyenne. Au lieu d'écrire plusieurs lignes pour additionner les valeurs et diviser par la longueur du tableau, ArrayAvg() encapsule cette logique en une seule instruction, ce qui réduit les risques d'erreur et améliore la maintenance du code.
- Dans un contexte de performance, ArrayAvg() est optimisée pour les tableaux de taille modérée. Pour des volumes massifs de données, il peut être plus judicieux d'utiliser des techniques de traitement par flux ou des fonctions d'agrégation côté base de données avant d'envoyer les données à Lucee, afin d'éviter une surcharge mémoire inutile.
Exemple
Voici des exemples typiques d'utilisation de cette fonction :
- <cfscript>
- numbers = [ 1, 2, 3, 4, 5 ];
- avgValue = ArrayAvg( numbers );
- Echo( avgValue ); // Sortie 3
- </cfscript>
Dernière mise à jour : Jeudi, le 14 Août 2025