HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

641

642

643

644

645

646

647

648

649

650

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);

Itanium(R)-based System 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 round-

ing direction.

llrint() is equivalent to lrint(), except that it rounds to

long long instead of long int.

Itanium-based System 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 Itanium-based systems)

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 com-

piler or linker command line.

For more information, see the HP-UX Floating-Point Guide.

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 Itanium-based sys-

tems, 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.