Mathematical Library Functions                        llround(3M)



NAME
     llround, llroundf, llroundl - round to nearest integer value

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

     long long llround(double x);


     long long llroundf(float x);


     long long llroundl(long double x);


DESCRIPTION
     These functions rounds their argument to the nearest integer
     value,  rounding halfway cases away from 0 regardless of the
     current rounding direction.

RETURN VALUES
      Upon successful  completion,  these  functions  return  the
     rounded integer value.


     If x is NaN, a domain error occurs and an unspecified  value
     is returned.


     If x is ]Inf, a domain error occurs and an unspecified value
     is returned.


     If x is -Inf, a domain error occurs and an unspecified value
     is returned.


     If the correct value is positive and too large to  represent
     as  a  long  long,  a domain error occurs and an unspecified
     value is returned.


      If the correct value is negative and too large to represent
     as  a  long  long,  a domain error occurs and an unspecified
     value is returned.

ERORS
     These functions will fail if:

     Domain Error    The x  argument  is  NaN  or  ]Inf,  or  the
                     correct  value  is  not  representable as an



SunOS 5.11          Last change: 12 Jul 2006                    1






Mathematical Library Functions                        llround(3M)



                     integer.

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


USAGE
     An application wanting to check for exceptions  should  call
     feclearexcept(FEALEXCEPT) before calling these functions.
     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.


     These functions differ from the llrint(3M) functions in that
     the  default  rounding direction for the llround() functions
     round halfway cases away from 0 and need not raise the inex-
     act  floating-point exception for non-integer arguments that
     round to within the range of the return type.

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



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


SEE ALSO
     feclearexcept(3M), fetestexcept(3M), llrint(3M),  lrint(3M),
     lround(3M), math.h(3HEAD), attributes(5), standards(5)













SunOS 5.11          Last change: 12 Jul 2006                    2