ldexp(3C)

NAME

     ldexp - load exponent of a floating point number

SYNOPSIS

     #include <math.h>

     double ldexp(double x, int exp);

DESCRIPTION

     The ldexp() function computes the quantity x* 2**exp.

RETURN VALUES

     Upon  successful  completion,  ldexp()  returns   a   double
     representing the value x multiplied by 2 raised to the power
     exp.

     If the value of x is NaN, NaN is returned.

     If ldexp()  would  cause  overflow,  _HUGE_VAL  is  returned
     (according to the sign of x), and errno is set to ERANGE.

     If ldexp() would cause underflow to 0.0, 0 is  returned  and
     errno may be set to ERANGE.

ERRORS

     The ldexp() function will fail if:

     ERANGE
           The value to be returned would have caused overflow.

     The ldexp() function may fail if:

     ERANGE
           The value to be returned would have caused underflow.

USAGE

     An application wishing to check for error situations  should
     set  errno to 0 before calling ldexp(). If errno is non-zero
     on return,  or  the  return  value  is  NaN,  an  error  has
     occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

     frexp(3C), isnan(3M), attributes(5)