Skip to main content Skip to complementary content

RangeNullCount - script and chart function

RangeNullCount() finds the number of NULL values in the expression or field.

Syntax:  

RangeNullCount(firstexpr [,Expression})

Return data type: integer

Arguments:  

The argument expressions of this function may contain inter-record functions with a third optional parameter, which in themselves return a range of values.

Argument Description
first_expr The expression or field containing the data to be measured.
Expression Optional expressions or fields containing the range of data to be measured.

Examples and results:  

Examples Results
RangeNullCount (1,2,4)

Returns 0

RangeNullCount (5,'abc') Returns 0
RangeNullCount (null( ), null( ))

Returns 2

Example with expression:

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

Returns the number of NULL values in the three results of the Sum(MyField) function evaluated on the current row and two rows above the current row.

Data used in examples:

Information noteCopying MyField in example below will not result in NULL value.
MyField

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

10 Returns 2 because there are no rows above this row so 2 of the 3 values are missing (=NULL).
2 Returns 1 because there is only 1 row above the current row so 1 of the 3 values is missing (=NULL).
8 Returns 1 because 1 of the 3 rows includes a non-numeric ('abc').
null Returns 1 because current row is a NULL value.
5 Returns 1 because row above is a NULL value.
9 Returns 1 because value 2 rows above the current row is a NULL value.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!