RangeMode() permet de déterminer la valeur la plus fréquente (valeur de mode) contenue dans l'expression ou le champ.
RangeMode(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 à mesurer.
- Expression : Expressions ou champs facultatifs contenant la plage de données à mesurer.
Si plusieurs valeurs présentent la fréquence la plus élevée, la valeur NULL est renvoyée.
| Exemple | Résultat |
|---|---|
| RangeMode (1,2,9,2,4) |
Renvoie 2. |
| RangeMode ('a',4,'a',4) |
Renvoie NULL. |
| RangeMode (null( )) |
Renvoie NULL. |
(avec une expression)
RangeMode (Above(MyField,0,3))
Renvoie la valeur la plus fréquente dans les trois résultats de MyField évalué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 RangeMode().
| MyField | RangeMode(Above(MyField,0,3)) |
|---|---|
| 10 | Renvoie 10, car il n'y a aucune ligne au-dessus. La valeur unique est donc celle qui est la plus fréquente. |
| 2 | - |
| 8 | - |
| 18 | - |
| 5 | - |
| 9 | - |
Données utilisées dans les exemples :
RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;
(sous forme de table)
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, RangeMode(Field1,Field2,Field3) as MyRangeMode 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 MyRangeMode pour chaque enregistrement de la table.
| RangeID | MyRangeMode |
|---|---|
| 1 | - |
| 2 | - |
| 3 | 8 |
| 4 | - |
| 5 | 5 |
| 6 | - |
