# RangeCount – função de script e gráfico

RangeCount() retorna o número de valores, de texto e numéricos, na expressão ou campo.

Sintaxe:

RangeCount(first\_expr[, Expression])

Tipo de dados de retorno: inteiro

Argumentos:

O argumento dessa função pode conter funções inter-registro, o que por si só retorna uma lista de valores.

* first\_expr: a expressão ou campo que contém os dados a serem contados.
* Expression: expressões ou campos opcionais contendo dados adicionais a serem contados.

Limitações:

Valores NULL não são contados.

Exemplos:

Exemplos e resultados

| Exemplo | Resultado |
| --- | --- |
| `RangeCount<br>(1,2,4)` | Retorna 3 |
| `RangeCount<br>(2,'xyz')` | Retorna 2 |
| `RangeCount<br>(null( ))` | Retorna 0 |
| `RangeCount<br>(2,'xyz', null())` | Retorna 2 |

Exemplo: (usando a expressão)

`RangeCount
			(Above(MyField,1,3))`

Retorna o número de valores contidos nos três resultados do MyField. Ao especificar o segundo e terceiro argumentos da função Above() como 3, retorna os valores dos três campos acima da linha atual, onde há linhas suficientes, que são usadas como entrada para a função RangeSum().

Exemplo de saída de expressão

| MyField | RangeCount(Above(MyField,1,3)) |
| --- | --- |
| 10 | 0 |
| 2 | 1 |
| 8 | 2 |
| 18 | 3 |
| 5 | 3 |
| 9 | 3 |

**Dados usados nos exemplos:**

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

Exemplo: (em forma de tabela)

Adicione o script de exemplo ao seu documento e execute-o. Em seguida, adicione pelo menos os campos listados na coluna de resultados a um documento para ver o resultado.

`RangeTab3:` `LOAD recno() as RangeID, RangeCount(Field1,Field2,Field3) as MyRangeCount INLINE [` `Field1, Field2, Field3` `10,5,6` `2,3,7` `8,2,8` `18,11,9` `5,5,9` `9,4,2`

`];`

A tabela resultante mostra os valores retornados deMyRangeCount para cada registro na tabela.

Exemplo de saída em forma de tabela

| RangeID | MyRangeCount |
| --- | --- |
| 1 | 3 |
| 2 | 3 |
| 3 | 3 |
| 4 | 3 |
| 5 | 3 |
| 6 | 3 |

## Saiba mais

* [Count](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/CounterAggregationFunctions/count.htm)
* [NumCount – função de script e gráfico](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/NumCount.htm)