HPlogo HP-UX Reference > L

llround(3M)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

NAME

llround(), llroundf(), llroundl(), llroundw(), llroundq() — round to long long functions

SYNOPSIS

#include <math.h>

long long llround(double x);

Itanium(R)-based System Only

long long llroundf(float x);

long long llroundl(long double x);

long long llroundw(extended x);

long long llroundq(quad x);

DESCRIPTION

llround() rounds its argument to the nearest integral value. An argument exactly halfway between two integers is rounded away from zero, regardless of the current rounding direction. Rounding away from zero also applies to the functions, round and lround.

llround() is equivalent to lround(), except that it rounds to long long instead of long int.

Itanium-based System Only

llroundf() is a float version of llround(); it takes a float argument.

llroundl() is a long double version of llround(); it takes a long double argument.

llroundw() is an extended version of llround(); it takes an extended argument.

llroundq() is equivalent to llroundl() 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) llroundw() or llroundq(), 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 llround() raises no other floating-point exception and the result differs from the argument, the function may raise the inexact floating-point exception.

ERRORS

No errors are defined.

STANDARDS CONFORMANCE

llround(), llroundf(), llroundl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')