RangeNullCount() finds the number of NULL values in the expression or field.
Syntax:
RangeNullCount(first_expr [, Expression])
Return data type: integer
Arguments:
The arguments of this function may contain inter-record functions which in themselves return a list 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.
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). |
| '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. |
Data used in examples:
RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
] ;