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
Les arguments de cette fonction peuvent contenir des fonctions d'inter-enregistrements, qui renvoient à leur tour une liste de valeurs.
| Argument | Description |
|---|---|
| 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.
| Exemples | Résultats |
|---|---|
| RangeMode (1,2,9,2,4) |
Renvoie 2. |
| RangeMode ('a',4,'a',4) |
Renvoie NULL. |
| RangeMode (null( )) |
Renvoie NULL. |
Ajoutez l'exemple de script à votre application et exécutez-le. Pour afficher le résultat, ajoutez les champs répertoriés dans la colonne de résultats à une feuille de votre application.
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 | MyRangMode |
|---|---|
| 1 | - |
| 2 | - |
| 3 | 8 |
| 4 | - |
| 5 | 5 |
| 6 | - |
Exemple contenant 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().
Données utilisées dans l'exemple :
RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;
| 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 | - |