llround.3m (2010 09)

llround(3M) llround(3M)

NAME

llround( ), llroundf( ), llroundl( ), llroundw( ), llroundq( ) - round to long long functions

SYNOPSIS

#include <math.h>

long long llround(double x);

HP Integrity Server Only

long long llroundf(float x);

long long llroundl(long double x);

long long llroundw(extended x);

long long llroundq(quad x);

DESCRIPTION

llround() 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 lround.

llround() is equivalent to lround(), except that it rounds to

long long instead of long int.

Integrity Server Only

llroundf() is a float version of llround(); it takes a float argument.

llroundl() is a long double version of llround(); it takes a long double argument.

llroundw() is an extended version of llround(); it takes an extended argument.

llroundq() is equivalent to llroundl() 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)

llroundw() or llroundq(), 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 ﬂoating-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 long, the numeric result is the maximum or

minimum long long value and the invalid ﬂoating-point exception is raised. On Integrity servers, if

the rounded value is outside the range of long long, the numeric result is the minimum long long

value.

When

llround() raises no other ﬂoating-point exception and the result differs from the argument, the

function may raise the inexact ﬂoating-point exception.

ERRORS

No errors are deﬁned.