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 floating-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 floating-point exception and the result differs from the argument, the function raises the inexact floating-point exception.

ERRORS

No errors are defined.

STANDARDS CONFORMANCE

llrint(), llrintf(), llrintl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')