Load exponent: multiply a floating-point number by an integral power of 2
#include <math.h> double ldexp( double x, int exp ); float ldexp( float x, int exp ); long double ldexpl( long double x, int exp );
These functions multiply the floating-point number x by 2exp.
To check for error situations, use feclearexcept() and fetestexcept(). For example:
x * 2exp
If: | These functions return: | Errors: |
---|---|---|
x is ±0.0 | x | — |
x is ±Inf | x | — |
x is NaN | x | — |
The result would cause overflow | Inf | FE_OVERFLOW |
The correct value would cause underflow | The correct value, after rounding | — |
These functions raise FE_INEXACT if the FPU reports that the result can't be exactly represented as a floating-point number.
#include <stdio.h> #include <math.h> #include <fenv.h> #include <stdlib.h> int main( void ) { int except_flags; double value; feclearexcept(FE_ALL_EXCEPT); value = ldexp( 4.7072345, 5 ); except_flags = fetestexcept(FE_ALL_EXCEPT); if(except_flags) { /* An error occurred; handle it appropriately. */ } printf( "%f\n", value ); return EXIT_SUCCESS; }
produces the output:
150.631504
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | No |
Thread | Yes |