Documentation Archive Developer
Search
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 speci-fied. specified.
     fied.  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