# RangeNullCount Função de script e de gráfico

RangeNullCount() encontra o número de valores NULL na expressão ou campo.

Sintaxe:

RangeNullCount(first\_expr [, Expression])

Tipo de dados de retorno: inteiro

Argumentos:

Os argumentos dessa função podem conter funções interregistro, que por si só retornam um intervalo de valores.

Argumentos

| Argumento | Descrição |
| --- | --- |
| first\_expr | A expressão ou campo que contém os dados a serem medidos. |
| Expression | Expressões ou campos opcionais que contêm o intervalo de dados a ser medido. |

Exemplos e resultados:

Exemplos de funções

| Exemplos | Resultados |
| --- | --- |
| `RangeNullCount<br>(1,2,4)` | Retorna 0 |
| `RangeNullCount<br>(5,'abc')` | Retorna 0 |
| `RangeNullCount<br>(null( ), null( ))` | Retorna 2 |

Exemplo com a expressão:

`RangeNullCount
 (Above(Sum(MyField),0,3))`

Retorna o número de NULL valores nos três resultados da função Sum(MyField) avaliada na linha atual e duas linhas acima da atual.

Nota informativaCopiar MyField no exemplo abaixo não resultará no valor NULL.

Dados de amostra

| MyField | RangeNullCount(Above(Sum(MyField),0,3)) |
| --- | --- |
| 10 | Retorna 2 porque não existem linhas acima desta linha, portanto 2 dos 3 valores estão ausentes (=NULL). |
| 'abc' | Retorna 1 porque existe apenas uma linha acima da linha atual, portanto um dos três valores está ausente (=NULL). |
| 8 | Retorna 0 porque nenhuma das três linhas é um valor NULL. |

Dados usados nos exemplos:

`RangeTab:` `LOAD * INLINE [` `MyField` `10` `'abc'` `8` `] ;`

## Saiba mais

* [NullCount - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/nullcount.htm)