ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



RINT(3)                  BSD Library Functions Manual                  RINT(3)

NAME
     rint, lrint, llrint -- round to integral value

SYNOPSIS
     #include <math.h>

     double
     rint(double x);

     long double
     rintl(long double x);

     float
     rintf(float x);

     long int
     lrint(double x);

     long int
     lrintl(long double x);

     long int
     lrintf(float x);

     long long int
     llrint(double x);

     long long int
     llrintl(long double x);

     long long int
     llrintf(float x);

DESCRIPTION
     The rint() functions return the integral value nearest to x (according to the prevailing rounding mode)
     in floating-point format.

     The lrint() and llrint() functions return the integral value nearest to x (according to the prevailing
     rounding mode) in the return formats specified.  If the rounded value is outside the range of the
     return type, the numeric result is unspecified and the "invalid" floating-point exception is raised. A
     range error may occur if the magnitude of x is too large.

SPECIAL VALUES
     rint(+-0) returns +-0 for all rounding modes.

     rint(+-infinity) returns +-infinity for all rounding modes.

     All these functions raise the "inexact" floating-point exception if the result differs in value from
     the argument (except when they raise some other floating-point exception, such as "invalid").

SEE ALSO
     abs(3), fabs(3), ceil(3), floor(3), math(3)

STANDARDS
     The rint() , lrint() , and llrint() functions conform to ISO/IEC 9899:1999(E).

BSD                            January 23, 2003                            BSD

Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.