# RangeAvg - fonction de script et fonction de graphique

RangeAvg() renvoie la moyenne d'une plage. Vous pouvez saisir une plage de valeurs ou une expression pour cette fonction.

RangeAvg(first\_expr[, Expression])

numérique

L'argument de cette fonction peut contenir des fonctions d'inter-enregistrements, qui renvoient à leur tour une liste de valeurs.

* first\_expr : expression ou champ contenant les données dont la moyenne doit être calculée.
* Expression : expressions ou champs facultatifs contenant des données supplémentaires dont la moyenne doit être calculée. Il est possible d'utiliser plusieurs expressions supplémentaires.

Si la fonction ne trouve aucune valeur numérique, elle renvoie la valeur NULL.

Exemples et résultats

| Exemple | Résultat |
| --- | --- |
| `RangeAvg<br>(1,2,4)` | Renvoie 2.33333333. |
| `RangeAvg<br>(1,'xyz')` | Renvoie 1. |
| `RangeAvg<br>(null( ), 'abc')` | Renvoie NULL. |

(à l'aide d'une expression)

` RangeAvg  (Above(MyField),0,3))  `

Renvoie une moyenne mobile du résultat de la plage de trois valeurs de MyField calculée sur la ligne active et les deux lignes au-dessus. En spécifiant 3 pour le troisième argument, la fonction Above() renvoie trois valeurs, s'il y a suffisamment de lignes au-dessus, utilisées comme données d'entrée dans la fonction RangeAvg().

Note ConseilDésactivez la fonction de tri de MyField pour vous assurer que l'exemple fonctionne comme prévu.

Exemple de sortie d'expression

| MyField | RangeAvg (Above(MyField,0,3)) | Explication |
| --- | --- | --- |
| 10 | 10 | Puisqu'il s'agit de la ligne du haut, la plage ne comporte qu'une seule valeur. |
| 2 | 6 | Il n'existe qu'une seule ligne au-dessus de cette ligne, la plage est donc : 10,2. |
| 8 | 6.6666666667 | Équivalent de RangeAvg(10,2,8) |
| 18 | 9.333333333 | - |
| 5 | 10. 333333333 | - |
| 9 | 10.6666666667 | - |

**Données utilisées dans les exemples :**

`RangeTab:` `LOAD * INLINE [` `MyField` `10` `2` `8` `18` `5` `9` `] ;`

(sous forme de tableau)

Ajoutez l'exemple de script à votre document et exécutez-le. Ensuite, ajoutez au moins les champs répertoriés dans la colonne des résultats à une feuille de votre document afin de visualiser le résultat.

`RangeTab3:` `LOAD recno() as RangeID, RangeAvg(Field1,Field2,Field3) as MyRangeAvg INLINE [` `Field1, Field2, Field3` `10,5,6` `2,3,7` `8,2,8` `18,11,9` `5,5,9` `9,4,2`

`];`

La table résultante affiche les valeurs renvoyées par la fonction MyRangeAvg pour chaque enregistrement de la table.

Exemple de sortie sous forme de tableau

| RangeID | MyRangeAvg |
| --- | --- |
| 1 | 7 |
| 2 | 4 |
| 3 | 6 |
| 4 | 12.666 |
| 5 | 6.333 |
| 6 | 5 |

## En savoir plus

* [Avg - fonction de graphique](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Count](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/CounterAggregationFunctions/count.htm)
* [NumAvg](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/NumAvg.htm)