Mathematical Library Functions                           exp2(3M)



NAME
     exp2, exp2f, exp2l - exponential base 2 functions

SYNOPSIS
     c99 [ flag... ] file... -lm [ library... ]
     #include 

     double exp2(double x);


     float exp2f(float x);


     long double exp2l(long double x);


DESCRIPTION
     These functions compute the base-2 exponential of x.

RETURN VALUES
     Upon successful completion, these functions return 2^x.


     If the correct value would cause  overflow,  a  range  error
     occurs  and exp2(), exp2f(), and exp2l() return the value of
     the macro HUGEVAL, HUGEVALF, and HUGEVAL, respectively.


     If x is NaN, a NaN is returned.


     If x is ]0, 1 is returned.


     If x is -Inf, ]0 is returned.


     If x is ]Inf, x is returned.

ERORS
     These functions will fail if:

     Range Error    The result overflows.

                    If the integer expression (matherrhandling &
                    MATHEREXCEPT)  is  non-zero,  the  overflow
                    floating-point exception will be raised.


USAGE
     An application wanting to check for exceptions  should  call
     feclearexcept(FEALEXCEPT) before calling these functions.



SunOS 5.11          Last change: 12 Jul 2006                    1






Mathematical Library Functions                           exp2(3M)



     On  return,  if  fetestexcept(FEINVALID    FEDIVBYZERO  
     FEOVERFLOW    FEUNDERFLOW)  is non-zero, an exception has
     been raised. An application should either examine the return
     value  or check the floating point exception flags to detect
     exceptions.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     exp(3M),  feclearexcept(3M),  fetestexcept(3M),   isnan(3M),
     log(3M), math.h(3HEAD), attributes(5), standards(5)































SunOS 5.11          Last change: 12 Jul 2006                    2