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

Пример: (использование выражения)

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

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

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

Пример результата выражения

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

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

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

Пример: (в виде таблицы)

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

`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 | MyRangeMode |
| --- | --- |
| 1 | - |
| 2 | - |
| 3 | 8 |
| 4 | - |
| 5 | 5 |
| 6 | - |

## Подробнее

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