lround man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

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  feclearex‐
       cept(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)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net