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