SCALBLN 3CW "09 March 2006" "mathcw-1.00"

Table of contents


NAME

scalblnf, scalbln, scalblnl, scalblnw, scalblnq, scalblnll, scalblndf, scalblnd, scalblndl, scalblndll - scale floating-point number by power of FLT_RADIX

SYNOPSIS

cc [ flags ] -I/usr/local/include file(s) -L/usr/local/lib -lmcw [ ... ]

#include <mathcw.h>

extern float scalblnf (float x, long int n);

extern double scalbln (double x, long int n);

extern long double scalblnl (long double x, long int n);

extern __float80 scalblnw (__float80 x, long int n);

extern __float128 scalblnq (__float128 x, long int n);

extern long_long_double scalblnll (long_long_double x, long int n);

extern decimal_float scalblndf (decimal_float x, long int n);

extern decimal_double scalblnd (decimal_double x, long int n);

extern decimal_long_double scalblndl (decimal_long_double x, long int n);

extern decimal_long_long_double scalblndll (decimal_long_long_double x, long int n);

NB: Functions with prototypes containing underscores in type names may be available only with certain extended compilers.


DESCRIPTION

Compute the product of x and the value of FLT_RADIX raised to the power n. In the absence of underflow and overflow of the result, this scaling is always exact.

A companion function, scalbn(x,n), provides for a lower-precision exponent.


RETURN VALUES

Return the computed product.

ERRORS

If the first argument is +Infinity, -Infinity, or a NaN, the result is that argument. If the product would overflow, the result is Infinity with the sign of the first argument. However, errno is never set.

SEE ALSO

frexp(3CW), ldexp(3CW), logb(3CW), pow(3CW), scalbn(3CW).