cppreference.com

Log in

Namespaces

Variants

Views

Actions

NAN

From cppreference.com

< c‎ | numeric‎ | math

Compiler support

Program utilities

Variadic function support

Dynamic memory management

Strings library

Date and time utilities

Input/output support

Localization support

Concurrency support (C11)

Technical Specifications

Common mathematical functions

Floating-point environment (C99)

Pseudo-random number generation

Complex number arithmetic (C99)

Type-generic math (C99)

Bit manipulation (C23)

Checked integer arithmetic (C23)

Common mathematical functions

Functions

Basic operations

abslabsllabsimaxabs

(C99)(C99)

divldivlldivimaxdiv

(C99)(C99)

(C99)

(C99)

(C99)

(C99)

nannanfnanlnandN

(C99)(C99)(C99)(C23)

Maximum/minimum operations

(C99)

(C99)

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

fmaximum_mag_num

(C23)

fminimum_mag_num

(C23)

Exponential functions

(C23)

(C99)

(C99)

(C23)

(C23)

(C99)

(C99)(C23)

(C23)

(C23)

Power functions

(C99)

(C23)

(C23)

(C99)

(C23)

(C23)

(C23)

Trigonometric and hyperbolic functions

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

(C99)

(C99)

(C99)

Nearest integer floating-point

roundlroundllround

(C99)(C99)(C99)

(C23)

(C99)

(C99)

rintlrintllrint

(C99)(C99)(C99)

fromfpfromfpxufromfpufromfpx

(C23)(C23)(C23)(C23)

Floating-point manipulation

(C99)(C99)

(C99)(C23)

(C99)

nextafternexttoward

(C99)(C99)

(C23)(C23)

(C99)

(C23)

Narrowing operations

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

Quantum and quantum exponent

(C23)

(C23)

(C23)

(C23)

Decimal re-encoding functions

(C23)

(C23)

(C23)

(C23)

Total order and payload functions

(C23)

(C23)

(C23)

(C23)

Classification

(C99)

(C23)

(C99)

(C99)

(C99)

(C99)

(C99)

(C23)

(C23)

(C99)

(C99)

(C99)

(C99)

(C99)

(C99)

(C23)

(C23)

Error and gamma functions

(C99)

(C99)

(C99)

(C99)

Types

div_tldiv_tlldiv_timaxdiv_t

(C99)(C99)

float_tdouble_t

(C99)(C99)

_Decimal32_t_Decimal64_t

(C23)(C23)

Macro constants

Special floating-point values

HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN

(C99)(C99)(C23)

INFINITYDEC_INFINITY

(C99)(C23)

NANDEC_NAN

(C99)(C23)

Arguments and return values

FP_ILOGB0FP_ILOGBNAN

(C99)(C99)

FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN

(C99)(C99)(C99)(C99)(C99)

FP_LLOGB0FP_LLOGBNAN

(C23)(C23)

FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST

(C23)(C23)(C23)(C23)(C23)

Error handling

MATH_ERRNOMATH_ERRNOEXCEPT

(C99)(C99)

math_errhandling

(C99)

Fast operation indicators

FP_FAST_FMAFFP_FAST_FMA

(C99)(C99)

FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN

(C23)(C23)(C23)(C23)

FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN

(C23)(C23)(C23)(C23)

FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN

(C23)(C23)(C23)(C23)

FP_FAST_FMALFP_FAST_FMADN

(C99)(C23)

FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN

(C23)(C23)(C23)(C23)

FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN

(C23)(C23)(C23)(C23)

FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN

(C23)(C23)(C23)(C23)

Defined in header <math.h>

#define NAN /*implementation defined*/

(since C99)

The macro NAN expands to a constant expression of type float, which evaluates to a quiet not-a-number (QNaN) value. If the implementation does not support QNaNs, this macro constant is not defined.

The style used to print a NaN is implementation-defined.

Contents

1 Notes
2 Example
3 References
4 See also

[edit] Notes

There are many different NaN values, differentiated by their payloads and their sign bits. The contents of the payload and the sign bit of the NaN generated by the macro NAN are implementation-defined.

[edit] Example

Show style used to print a NaN and IEEE format.

Run this code

#include <inttypes.h>
#include <math.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>
 
int main(void)
{
 const double f = NAN;
 uint64_t fn;
 memcpy (&fn, &f, sizeof f);
 printf ("NAN:  %f %" PRIx64 "\n", f, fn);
}

Possible output:

NAN: nan 7ff8000000000000

[edit] References

C23 standard (ISO/IEC 9899:2024):

7.12/5 NAN (p: TBD)

F.10/11/13 NAN (p: TBD)

C17 standard (ISO/IEC 9899:2018):

7.12/5 NAN (p: TBD)

F.10/11/13 NAN (p: TBD)

C11 standard (ISO/IEC 9899:2011):

7.12/5 NAN (p: 232)

F.10/11/13 NAN (p: 518)

C99 standard (ISO/IEC 9899:1999):

7.12/5 NAN (p: 213)

F.9/11/13 NAN (p: 455)

[edit] See also

(C99)(C99)(C99)

returns a NaN (not-a-number)
(function) [edit]

(C99)

checks if the given number is NaN
(function macro) [edit]

C++ documentation for NAN

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=c/numeric/math/NAN&oldid=150797"