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

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

Sintaxe:

RangeNullCount(firstexpr [, 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 medidos.
* Expression: Expressões ou campos opcionais que contêm o intervalo de dados a ser medido.

Exemplos:

Exemplos e resultados

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

Exemplo: (usando a expressão)

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

Retorna o número de valores NULL 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.

Nota de dicaDesative a classificação de MyField para garantir que o exemplo funcione como esperado.

Exemplo de saída de expressão

| 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](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/CounterAggregationFunctions/nullcount.htm)