SCALBLN(3) Library Functions Manual SCALBLN(3)

scalbln scalblnf scalblnl scalbn scalbnf scalbnl — compute exponent using FLT_RADIX

#include <math.h>

double scalbln(double x, long n);
float scalblnf(float x, long n);
long double scalblnl(long double x, long n);
double scalbn(double x, int n);
float scalbnf(float x, int n);
long double scalbnl(long double x, int n);

The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2008 defers to the ISO C standard.

These functions shall compute x * FLT_RADIX n efficiently, not normally by computing FLT_RADIX n explicitly.

An application wishing to check for error situations should set errno to zero and call (FE_ALL_EXCEPT) before calling these functions. On return, if errno is non-zero or (FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is non-zero, an error has occurred.

Upon successful completion, these functions shall return x * FLT_RADIX n.

If the result would cause overflow, a range error shall occur and these functions shall return ±HUGE_VAL, ±HUGE_VALF, and ±HUGE_VALL (according to the sign of x) as appropriate for the return type of the function.

If the correct value would cause underflow, [MXX] and is not representable, a range error may occur, and scalbln (), (), (), (), (), and () shall return [MXX] 0.0, or (if IEC 60559 Floating-Point is not supported) an implementation-defined value no greater in magnitude than DBL_MIN, FLT_MIN, LDBL_MIN, DBL_MIN, FLT_MIN, and LDBL_MIN, respectively.

If x is NaN, a NaN shall be returned.

If x is ±0 or ±Inf, x shall be returned.

If n is 0, x shall be returned.

[MXX] If the correct value would cause underflow, and is representable, a range error may occur and the correct value shall be returned.

These functions shall fail if:

The result overflows. If the integer expression ( math_errhandling & MATH_ERRNO) is non-zero, then errno shall be set to [ERANGE]. If the integer expression ( math_errhandling & MATH_ERREXCEPT) is non-zero, then the overflow floating-point exception shall be raised.

These functions may fail if:

The result underflows. If the integer expression ( math_errhandling & MATH_ERRNO) is non-zero, then errno shall be set to [ERANGE]. If the integer expression ( math_errhandling & MATH_ERREXCEPT) is non-zero, then the underflow floating-point exception shall be raised.

None.

On error, the expressions ( math_errhandling & MATH_ERRNO) and ( math_errhandling & MATH_ERREXCEPT) are independent of each other, but at least one of them must be non-zero.

These functions are named so as to avoid conflicting with the historical definition of the scalb(3) function from the Single UNIX Specification. The difference is that the scalb(3) function has a second argument of instead of int. The scalb(3) function is not part of the ISO C standard. The three functions whose second type is are provided because the factor required to scale from the smallest positive floating-point value to the largest finite one, on many implementations, is too large to represent in the minimum-width int format.

None.

feclearexcept(3), fetestexcept(3)

XBD V1_chap04(7), <math.h>

First released in Issue 6. Derived from the ISO/IEC 9899:1999 (“ISO C99”) standard.

POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0521 [68] and XSH/TC1-2008/0522 [68] are applied.

January 1, 2013 posix.fail