Mathematical Library Functions                         remquo(3M)



NAME
     remquo, remquof, remquol - remainder functions

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

     double remquo(double x, double y, int *quo);


     float remquof(float x, float y, int *quo);


     long double remquol(long double x, long double y, int *quo);


DESCRIPTION
     The remquo(), remquof(), and remquol() functions compute the
     same remainder as the remainder(), remainderf(), and remain-
     derl() functions, respectively. See  remainder(3M).  In  the
     object  pointed  to by quo, they store a value whose sign is
     the sign of x/y and whose magnitude is congruent modulo  2^n
     to the magnitude of the integral quotient of x/y, where n is
     an integer greater than or equal to 3.

RETURN VALUES
     These functions return x REM y.


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


     If x is ]Inf or y is 0 and the other argument is non-NaN,  a
     domain error occurs and a NaN is returned.

ERORS
     These functions will fail if:

     Domain Error    The x argument is Inf or the y argument is 0
                     and the other argument is non-NaN.

                     If the integer expression  (matherrhandling
                     &  MATHEREXCEPT)  is  non-zero,  then  the
                     invalid floating-point exception is 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



SunOS 5.11          Last change: 12 Jul 2006                    1






Mathematical Library Functions                         remquo(3M)



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


































SunOS 5.11          Last change: 12 Jul 2006                    2