remquo(3M)						  Mathematical Library Functions						remquo(3M)

NAME

       remquo, remquof, remquol - remainder functions

SYNOPSIS

       cc [ flag... ] file... -lm [ library... ]
       #include <math.h>

       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 remainderl() 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.

ERRORS

       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  (math_errhandling & MATH_ERREXCEPT) is non-zero, then the invalid floating-point exception is
		       raised.

USAGE

       An application wanting to check for exceptions should call feclearexcept(FE_ALL_EXCEPT) before  calling	these  functions.  On  return,	if
       fetestexcept(FE_INVALID	|  FE_DIVBYZERO  |  FE_OVERFLOW  |  FE_UNDERFLOW) 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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE 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.10							    1 Sep 2002								remquo(3M)