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

llrint(3M) llrint(3M)

NAME

llrint( ), llrintf(), llrintl(), llrintw(), llrintq() - round to nearest long long functions

SYNOPSIS

#include <math.h>

long long llrint(double x);

HP Integrity Server Only

long long llrintf(float x);

long long llrintl(long double x);

long long llrintw(extended x);

long long llrintq(quad x);

DESCRIPTION

llrint() rounds its argument to the nearest integral value, rounding according to the current rounding

direction.

llrint() is equivalent to lrint(), except that it rounds to long long instead of long int

Integrity Server Only

llrintf() is a float version of llrint(); it takes a float argument.

llrintl() is a long double version of llrint(); it takes a long double argument.

llrintw() is an extended version of llrint(); it takes an extended argument.

llrintq() is equivalent to llrintl() 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)

llrintw() or llrintq(), 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

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

function raises the inexact ﬂoating-point exception.

ERRORS

No errors are deﬁned.