opensolaris man page for remquol

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

NAME
       remquo, remquof, remquol - remainder functions

SYNOPSIS
       c99 [ 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.11							    12 Jul 2006 							remquo(3M)