drem.3.gz

REMAINDER

NAME

drem, dremf, dreml, remainder, remainderf, remainderl -  floating-point remainder function

SYNOPSIS

#include <math.h>
 /* The C99 versions */
I double remainder(double  x , double  y );
I float remainderf(float  x , float  y );
I long double remainderl(long double  x , long double  y );
 /* Obsolete synonyms */
I double drem(double  x , double  y );
I float dremf(float  x , float  y );
I long double dreml(long double  x , long double  y );
 
Link with -lm.

DESCRIPTION

The R remainder () function computes the remainder of dividing x by R y . The return value is R x - n * y , where n is the value R x / y , rounded to the nearest integer. If this quotient is 1/2 (mod 1), it is rounded to the nearest even number (independent of the current rounding mode). If the return value is 0, it has the sign of R x .
The R drem () function does precisely the same thing.

RETURN VALUE

The R remainder () function returns the remainder, unless y is zero, when the function fails and errno is set.

ERRORS

EDOM
The denominator y is zero.

CONFORMING TO

IEC 60559. The functions R remainder (), R remainderf (), and R remainderl () are from C99. The function R drem () is from 4.3BSD. The float and long double variants R dremf () and R dreml () exist on some systems, such as Tru64 and glibc2.

EXAMPLE

The call "remainder(29.0, 3.0)" returns -1.

SEE ALSO

fmod(3), remquo(3)