6.11.134 nanf Function

Returns a quiet NaN single precision floating-point value.

Include

<math.h>

Prototype

float nanf(const char * tagp);

Arguments

tagp
an optional, implementation-defined string which might be used to represent extra information in the NaN’s significand

Return Value

The call nan("n-char-sequence") is equivalent to strtof("NAN(n-char- sequence)", (char**) NULL); the call nan("") is equivalent to strtof("NAN()", (char**) NULL). When tagp does not point to an n-char sequence or an empty string, the equivalent call to strtof would have a first argument of "NAN".

Example

See the notes at the beginning of this chapter or section for information on using printf() or scanf() (and other functions reading and writing the stdin or stdout streams) in the example code.

#include <math.h>
#include <stdio.h>

int main(void)
{
  float x;

  z = nanf(NULL);
  printf("Here is our not-a-number: %f\n", z);
}

Example Output

Here is our not-a-number: nan