# TextCount — функция диаграммы
TextCount() используется для агрегирования нечисловых значений поля в каждом измерении диаграммы.
Синтаксис:
TextCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)
Возвращаемые типы данных: integer
Аргументы:
Аргументы
| Аргумент | Описание |
| --- | --- |
| expr | Выражение или поле, содержащее данные для измерения. |
| SetExpression | По умолчанию функция агрегирования агрегирует множество возможных записей, определенных выборкой. Альтернативный набор записей может быть определен выражением анализа множества. |
| DISTINCT | Если слово DISTINCT указывается до аргументов функции, все дубликаты, возникшие в результате оценки аргументов функции, будут проигнорированы. |
| TOTAL | Если слово TOTAL стоит перед аргументами функции, вычисление выполняется по всем возможным значениям, указанным в текущих выборках, а не только в тех, которые относятся к значению текущего измерения, т. е. измерения диаграммы игнорируются.
При использовании выражения TOTAL [<fld {.fld}>], где префикс TOTAL предшествует списку из одного или нескольких имен полей, выступающих в качестве подмножества переменных измерения диаграммы, создается подмножество всех возможных значений.
[Определение объема агрегирования](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |
Примеры и результаты:
Data
| Customer | Product | OrderNumber | UnitSales | Unit Price |
| --- | --- | --- | --- | --- |
| Astrida | AA | 1 | 4 | 16 |
| Astrida | AA | 7 | 10 | 15 |
| Astrida | BB | 4 | 9 | 1 |
| Betacab | BB | 6 | 5 | 10 |
| Betacab | CC | 5 | 2 | 20 |
| Betacab | DD | | | 25 |
| Canutility | AA | | | 15 |
| Canutility | CC | | | 19 |
| Divadip | AA | 2 | 4 | 16 |
| Divadip | DD | 3 | | 25 |
Примеры и результаты
| Пример | Результат |
| --- | --- |
| `TextCount([Product])` | Значение 10, поскольку все из 10 полей в элементе Product текстовые.
Примечание к информации«0» считается значением, а не пустой ячейкой. Тем не менее, если мера агрегирует значение для измерения до 0, это измерение не будет включено в диаграммы. Пустые ячейки оцениваются как нетекстовые и не учитываются элементом TextCount. |
| `TextCount([OrderNumber])` | Значение 3, поскольку пустые ячейки учитываются. Обычно используется, чтобы убедиться, что в числовых полях нет текстовых или не нулевых значений. |
| `TextCount (DISTINCT [Product])/Count([Product)]` | Подсчитывается количество уникальных текстовых значений Product (4) и делится по итоговому количеству значений в элементе Product (10). Результат — 0,4. |
Данные, используемые в примере:
`Temp:` `LOAD * inline [` `Customer|Product|OrderNumber|UnitSales|UnitPrice` `Astrida|AA|1|4|16` `Astrida|AA|7|1|15` `Astrida|BB|4|9|9` `Betacab|CC|6|5|10` `Betacab|AA|5|2|20` ` Betacab|BB|||| 25 ` `Canutility|AA|||15` `Canutility|CC|||19` `Divadip|CC|2|4|16` `Divadip|DD|3|1|25` `] (delimiter is '|');`