HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

751

752

753

754

755

756

757

758

759

760

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 compiler

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.