# RangeMode Функция скрипта и диаграммы

RangeMode() находит наиболее часто встречающееся значение (значение режима) в выражении или поле.

Синтаксис:

RangeMode(first\_expr {, Expression})

Возвращаемые типы данных: число

Аргументы:

Аргументы этой функции могут содержать межзаписные функции, которые в свою очередь возвращают список значений.

Аргументы

| Аргумент | Описание |
| --- | --- |
| first\_expr | Выражение или поле, содержащее данные для измерения. |
| Expression | Дополнительные выражения или поля, содержащие диапазон значений для измерения. |

Ограничения:

Если одинаково часто встречаются несколько значений, возвращается значение NULL.

Примеры и результаты:

Примеры функции

| Примеры | Результаты |
| --- | --- |
| `RangeMode<br>(1,2,9,2,4)` | Возвращает 2 |
| `RangeMode<br>('a',4,'a',4)` | Возвращает NULL |
| `RangeMode<br>(null( ))` | Возвращает NULL |

Пример:

Добавьте образец скрипта в свое приложение и запустите. Чтобы увидеть результат, добавьте поля, перечисленные в столбце результатов, на лист в вашем приложении.

`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`

`];`

Результирующая таблица показывает возвращенные значения функции MyRangeMode для каждой записи в таблице.

Результирующая таблица

| RangeID | Мой ранговый режим |
| --- | --- |
| 1 | - |
| 2 | - |
| 3 | 8 |
| 4 | - |
| 5 | 5 |
| 6 | - |

Пример с выражением:

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

Возвращает наиболее часто встречающееся значение из трех результатов поля MyField, вычисленных в текущей строке и двух строках над ней. При указании третьего аргумента как 3 функция Above() возвращает три значения, над которыми достаточно строк и которые принимаются за вводимые значения в функцию RangeMode().

Данные, используемые в примере:

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

Примечание к подсказкеОтключите сортировку MyField, чтобы убедиться, что пример работает, как ожидается.

Данные образца

| MyField | RangeMode(Above(MyField,0,3)) |
| --- | --- |
| 10 | Возвращает 10, поскольку выше нет строк, поэтому одно значение является наиболее часто встречающимся. |
| 2 | - |
| 8 | - |
| 18 | - |
| 5 | - |
| 9 | - |

## Подробнее

* [Mode — функция диаграммы](https://help.qlik.com/ru-RU/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/BasicAggregationFunctions/mode.htm)