Manual page: lroundl(3)

LROUND(3)              FreeBSD Library Functions Manual              LROUND(3)

NAME

     llround, llroundf, llroundl, lround, lroundf, lroundl -- convert to near-
     est integral value

LIBRARY

     Math Library (libm, -lm)

SYNOPSIS

     #include <math.h>

     long long
     llround(double x);

     long long
     llroundf(float x);

     long long
     llroundl(long double x);

     long
     lround(double x);

     long
     lroundf(float x);

     long
     lroundl(long double x);

DESCRIPTION

     The lround() function returns the integer nearest to its argument x,
     rounding away from zero in halfway cases.  If the rounded result is too
     large to be represented as a long value, an invalid exception is raised
     and the return value is undefined.  Otherwise, if x is not an integer,
     lround() may raise an inexact exception.  When the rounded result is rep-
     resentable as a long, the expression lround(x) is equivalent to
     (long)round(x) (although the former may be more efficient).

     The llround(), llroundf(), llroundl(), lroundf() and lroundl() functions
     differ from lround() only in their input and output types.

SEE ALSO

     lrint(3), math(3), rint(3), round(3)

STANDARDS

     The llround(), llroundf(), llroundl(), lround(), lroundf(), and lroundl()
     functions conform to ISO/IEC 9899:1999 (``ISO C99'').

HISTORY

     The float and double versions of these routines first appeared in
     FreeBSD 5.4.  The long double versions appeared in FreeBSD 6.0.

FreeBSD 7.0                      April 7, 2005                     FreeBSD 7.0