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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

691

692

693

694

695

696

697

698

699

700

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 rounding

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 compiler

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