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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

711

712

713

714

715

716

717

718

719

720

lrint(3M) lrint(3M)

NAME

lrint(), lrintf( ), lrintl(), lrintw( ), lrintq() - round to nearest long int functions

SYNOPSIS

#include <math.h>

long int lrint(double x);

Itanium(R)-based System Only

long int lrintf(float x);

long int lrintl(long double x);

long int lrintw(extended x);

long int lrintq(quad x);

DESCRIPTION

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

direction.

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

Itanium-based System Only

lrintf() is a float version of lrint(); it takes a float argument.

lrintl() is a long double version of lrint(); it takes a long double argument.

lrintw() is an extended version of lrint(); it takes an extended argument.

lrintq() is equivalent to lrintl() 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)

lrintw() or lrintq(), 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 int, the numeric result is the maximum or minimum

long int value and the invalid ﬂoating-point exception is raised. On Itanium-based systems, if the

rounded value is outside the range of long int, the numeric result is the minimum long int

value.

When

lrint() 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.