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:
| 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). |
| 'abc' | Returns 1 because there is only one row above the current row, so one of the three values is missing (=NULL). |
| 8 | Returns 0 because none of the three rows is a NULL value. |
| null | Returns 1 because the current row is a NULL value. |
| 'xyz' | Returns 1 because the row above is a NULL value. |
| 9 | Returns 1 because the value two rows above the current row is a NULL value. |
Data used in examples:
RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
null()
'xyz'
9
] ;