isnan function in APL to check whether a numeric value is NaN (Not a Number). The function returns true when the value is NaN and false for all finite values and infinities.
isnan is essential for data quality work. Operations such as log of a negative number, sqrt of a negative number, or 0 / 0 produce NaN in APL. Use isnan to detect and filter these invalid values before aggregating, charting, or alerting on your data.
For users of other query languages
If you come from other query languages, this section explains how to adjust your existing queries to achieve the same results in APL.Splunk SPL users
Splunk SPL users
Splunk SPL includes the
isnan() function, which works the same way as in APL: it returns true (1) when the value is NaN.ANSI SQL users
ANSI SQL users
Standard SQL does not define an
ISNAN() function. In most dialects, NaN is not a concept; division by zero raises an error instead. However, some databases (such as PostgreSQL) do support NaN as a float value, and you check for it with value = 'NaN'.Usage
Syntax
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
x | real | Yes | The numeric value to check. |
Returns
true if x is NaN. false for finite values and infinity.
List of related functions
- isfinite: Returns
truefor values that are neither infinite nor NaN. Use it for a combined check covering all invalid float states. - isinf: Returns
trueonly for infinite values. Use it alongsideisnanto cover all edge cases. - isint: Returns
truefor integer values. Use it for whole-number validation rather than float validity. - log: Returns the natural logarithm. Use
isnanto catch NaN results whenlogis applied to non-positive values. - sqrt: Returns the square root. Use
isnanto detect NaN results fromsqrton negative inputs.