Defined in header <<fenv.h>> | ||||
---|---|---|---|---|
| (since C99) | |||
| (since C99) | |||
| (since C99) | |||
| (since C99) | |||
| (since C99) | |||
| (since C99) |
All these macro constants (except FE_ALL_EXCEPT
) expand to integer constant expressions that are distinct powers of 2, which uniquely identify all supported floating-point exceptions. Each macro is only defined if it is supported.
The macro constant FE_ALL_EXCEPT
, which expands to the bitwise OR of all other FE_*
, is always defined and is zero if floating-point exceptions are not supported by the implementation.
Constant | Explanation |
---|---|
FE_DIVBYZERO | pole error occurred in an earlier floating-point operation |
FE_INEXACT | inexact result: rounding was necessary to store the result of an earlier floating-point operation |
FE_INVALID | domain error occurred in an earlier floating-point operation |
FE_OVERFLOW | the result of an earlier floating-point operation was too large to be representable |
FE_UNDERFLOW | the result of an earlier floating-point operation was subnormal with a loss of precision |
FE_ALL_EXCEPT | bitwise OR of all supported floating-point exceptions |
The implementation may define additional macro constants in <fenv.h>
to identify additional floating-point exceptions. All such constants begin with FE_
followed by at least one uppercase letter.
See math_errhandling for further details.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | #include <stdio.h> #include <math.h> #include <float.h> #include <fenv.h> #pragma STDC FENV_ACCESS ON void show_fe_exceptions( void ) { printf ( "exceptions raised:" ); if (fetestexcept(FE_DIVBYZERO)) printf ( " FE_DIVBYZERO" ); if (fetestexcept(FE_INEXACT)) printf ( " FE_INEXACT" ); if (fetestexcept(FE_INVALID)) printf ( " FE_INVALID" ); if (fetestexcept(FE_OVERFLOW)) printf ( " FE_OVERFLOW" ); if (fetestexcept(FE_UNDERFLOW)) printf ( " FE_UNDERFLOW" ); feclearexcept(FE_ALL_EXCEPT); printf ( "\n" ); } int main( void ) { printf ( "MATH_ERREXCEPT is %s\n" , math_errhandling & MATH_ERREXCEPT ? "set" : "not set" ); printf ( "0.0/0.0 = %f\n" , 0.0/0.0); show_fe_exceptions(); printf ( "1.0/0.0 = %f\n" , 1.0/0.0); show_fe_exceptions(); printf ( "1.0/10.0 = %f\n" , 1.0/10.0); show_fe_exceptions(); printf ( "sqrt(-1) = %f\n" , sqrt (-1)); show_fe_exceptions(); printf ( "DBL_MAX*2.0 = %f\n" , DBL_MAX*2.0); show_fe_exceptions(); printf ( "nextafter(DBL_MIN/pow(2.0,52),0.0) = %.1f\n" , nextafter(DBL_MIN/ pow (2.0,52),0.0)); show_fe_exceptions(); } |
Possible output:
1 2 3 4 5 6 7 8 9 10 11 12 13 | MATH_ERREXCEPT is set 0.0/0.0 = nan exceptions raised: FE_INVALID 1.0/0.0 = inf exceptions raised: FE_DIVBYZERO 1.0/10.0 = 0.100000 exceptions raised: FE_INEXACT sqrt (-1) = -nan exceptions raised: FE_INVALID DBL_MAX*2.0 = inf exceptions raised: FE_INEXACT FE_OVERFLOW nextafter(DBL_MIN/ pow (2.0,52),0.0) = 0.0 exceptions raised: FE_INEXACT FE_UNDERFLOW |
References
- C11 standard (ISO/IEC 9899:2011):
- 7.6/6 Floating-point environment <fenv.h> (p: 207)
- C99 standard (ISO/IEC 9899:1999):
- 7.6/5 Floating-point environment <fenv.h> (p: 188)
See also
(C99)(C99)(C99) | defines the error handling mechanism used by the common mathematical functions (macro constant) |
C++ documentation for floating point exception macros |
Please login to continue.