Manualshelf

lround.3m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
l
lround(3M) lround(3M)
NAME
lround( ), lroundf( ), lroundl( ), lroundw( ), lroundq( ) - round to long int functions
SYNOPSIS
#include <math.h>
long int lround(double x);
HP Integrity Server Only
long int lroundf(float x);
long int lroundl(long double x);
long int lroundw(extended x);
long int lroundq(quad x);
DESCRIPTION
lround() rounds its argument to the nearest integral value. An argument exactly halfway between two
integers is rounded away from zero, regardless of the current rounding direction. Rounding away from
zero also applies to the functions, round and
llround.
lround() is equivalent to llround(), except that it rounds to
long int instead of long long.
Integrity Server Only
lroundf() is a float version of lround(); it takes a float argument.
lroundl() is a long double version of lround(); it takes a long double argument.
lroundw() is an extended version of lround(); it takes an extended argument.
lroundq() is equivalent to lroundl() on HP-UX systems.
USAGE
To use these functions, compile either with the default
-Ae option or with the
-Aa and
-D_HPUX_SOURCE options.
To use (for Integrity servers)
lroundw() or lroundq(), compile also with the -fpwidetypes
option.
Make sure your program includes
<math.h>. Link in the math library by specifying -lm on the com-
piler or linker command line.
For more information, see the HP-UX floating-point guide for HP Integrity servers at the following site:
http://www.hp.com/go/fp
.
RETURN VALUE
If the rounded value is outside the range of
long int, the numeric result is the maximum or minimum
long int value and the invalid floating-point exception is raised. On Integrity servers, if the rounded
value is outside the range of long int, the numeric result is the minimum long int value.
When
lround() raises no other floating-point exception and the result differs from the argument, the
function may raise the inexact floating-point exception.
ERRORS
No errors are defined.
SEE ALSO
ceil(3M), floor(3M), fabs(3M), fmod(3M), fegetround(3M), fesetround(3M), lrint(3M), llrint(3M),
llround(3M), rint(3M), round(3M), trunc(3M), math(5), fenv(5).
STANDARDS CONFORMANCE
lround(), lroundf(), lroundl() : ISO/IEC C99 (including Annex F, ‘‘IEC 60559 floating-point
arithmetic’’)
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)