RINT(3M) | Mathematical Library Functions | RINT(3M) |

rint, rintf, rintl - round-to-nearest integral value

c99 [flag... ]file...-lm[library... ] #include <math.h>doublerint(doublex);

floatrintf(floatx);

long doublerintl(long doublex);

These functions return the integral value (represented as a
**double**) nearest *x* in the direction of the current rounding
mode.

If the current rounding mode rounds toward negative infinity,
**rint()** is equivalent to floor(3M). If the current rounding
mode rounds toward positive infinity, **rint()** is equivalent to
ceil(3M).

These functions differ from the nearbyint(3M),
**nearbyintf()**, and **nearbyintl()** functions only in that they
might raise the inexact floating-point exception if the result differs in
value from the argument.

Upon successful completion, these functions return the integer
(represented as a double precision number) nearest *x* in the direction
of the current rounding mode.

If *x* is NaN, a NaN is returned.

If *x* is ±0 or ±Inf, *x* is returned.

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

ATTRIBUTE TYPE | ATTRIBUTE VALUE |

Interface Stability | Standard |

MT-Level | MT-Safe |

abs(3C), math.h(3HEAD), ceil(3M), feclearexcept(3M), fetestexcept(3M), floor(3M), isnan(3M), nearbyint(3M), attributes(7), standards(7)

July 12, 2006 | SunOS 5.11 |