lroundf(3m) [opensolaris man page]

lround(3M)						  Mathematical Library Functions						lround(3M)

NAME

       lround, lroundf, lroundl - round to nearest integer value

SYNOPSIS

       c99 [ flag... ] file... -lm [ library... ]
       #include <math.h>

       long lround(double x);

       long lroundf(float x);

       long lroundl(long double x);

DESCRIPTION

       These  functions round their argument to the nearest integer value, rounding halfway cases away from zero, regardless of the current round-
       ing direction.

RETURN VALUES

	Upon successful completion, these functions return the rounded integer value.

       If x is NaN, a domain error occurs and an unspecified value is returned.

       If x is +Inf, a domain error occurs and an unspecified value is returned.

       If x is -Inf, a domain error occurs and an unspecified value is returned.

       If the correct value is positive and too large to represent as a long, a domain error occurs and an unspecified value is returned.

       If the correct value is negative and too large to represent as a long, a domain error occurs and an unspecified value is returned.

ERRORS

       These functions will fail if:

       Domain Error    The x argument is NaN or +-Inf, or the correct value is not representable as an integer.

		       If the integer expression (math_errhandling & MATH_ERREXCEPT) is non-zero, then the  invalid  floating-point  exception	is
		       raised.

USAGE

       An  application	wanting  to  check  for  exceptions should call feclearexcept(FE_ALL_EXCEPT) before calling these functions. On return, if
       fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is non-zero, an exception  has  been  raised.  An  application  should
       either examine the return value or check the floating point exception flags to detect exceptions.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       feclearexcept(3M), fetestexcept(3M), llround(3M), math.h(3HEAD), attributes(5), standards(5)

SunOS 5.11							    12 Jul 2006 							lround(3M)