# TextCount - função de gráfico

TextCount() é utilizada para agregar o número de valores de campo que são não numéricos em cada dimensão de gráfico.

Sintaxe:

TextCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)

Tipo de dados de retorno: inteiro

Argumentos:

Argumentos

| Argumento | Descrição |
| --- | --- |
| expr | A expressão ou campo que contém os dados a serem medidos. |
| SetExpression | Por padrão, a função de agregação agregará um conjunto de registros possíveis definidos pela seleção. Um conjunto de registros alternativos pode ser definido por uma expressão de análise. |
| DISTINCT | Se a palavra DISTINCT aparecer antes dos argumentos de função, as duplicatas resultantes da avaliação dos argumentos de função serão ignoradas. |
| TOTAL | Se a palavra TOTAL ocorrer antes dos argumentos da função, o cálculo será feito sobre todos os valores possíveis, dadas as seleções atuais, e não apenas sobre os pertinentes ao valor dimensional atual, isto é, desconsiderando as dimensões do gráfico.<br><br>Usando TOTAL [&lt;fld {.fld}&gt;], em que o qualificador TOTAL é seguido por uma lista de um ou mais nomes de campo como um subconjunto das variáveis de dimensão de gráfico, você cria um subconjunto dos valores possíveis totais.<br><br>[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |

Exemplos e resultados:

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 |

Exemplos e resultados

| Exemplo | Resultado |
| --- | --- |
| `TextCount([Product])` | 10 porque todos os 10 campos em Product são de texto.<br><br>Nota informativa"0" conta como um valor, e não uma célula vazia. No entanto, se uma lista agregar ao 0 para uma dimensão, esta não será incluída nas tabelas. As células vazias são avaliadas como não sendo texto e não são contadas por TextCount. |
| `TextCount([OrderNumber])` | 3 porque as células vazias são contadas. Normalmente, você usa isso para verificar se nenhum campo numérico recebeu valores de texto ou se são não zero. |
| `TextCount (DISTINCT [Product])/Count([Product)]` | Conta todos os números de valores de texto distintos de Product (4) e divide-os pelo número total de valores em Product (10). O resultado é 0,4. |

Dados usados no exemplo:

`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 '|');`