manpagez: man pages & more
man lrintf(3)
Home | html | info | man
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.  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").


NOTE

     The rinttol() function is deprecated.  Please use the C99 function
     lrint() instead.


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                              July 02, 2008                             BSD

Mac OS X 10.6 - Generated Thu Sep 17 20:22:36 CDT 2009
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.