Mathematical Library Functions                           fmod(3M)



NAME
     fmod, fmodf, fmodl - floating-point remainder value function

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

     double fmod(double x, double y);


     float fmodf(float x, float y);


     long double fmodl(long double x, long double y);


DESCRIPTION
     These functions return the floating-point remainder  of  the
     division of x by y.

RETURN VALUES
     These functions return the value x - i * y, for some integer
     i  such that, if y is non-zero, the result has the same sign
     as x and magnitude less than the magnitude of y.


     If x or y is NaN, a NaN is returned.


     If y is 0, a domain error occurs and a NaN is returned.


     If x is infinite,  a  domain  error  occurs  and  a  NaN  is
     returned.


     If x is ]0 and y is not 0, ]0 is returned.


     If x is not infinite and y is ]Inf, x is returned.

ERORS
     These functions will fail if:

     Domain Error    The x argument is infinite or y is 0.

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






SunOS 5.11          Last change: 12 Jul 2006                    1






Mathematical Library Functions                           fmod(3M)



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.

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),        isnan(3M),
     math.h(3HEAD), attributes(5), standards(5)




























SunOS 5.11          Last change: 12 Jul 2006                    2