Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > L

lround(3M)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

lround(), lroundf(), lroundl(), lroundw(), lroundq() — round to long int functions

SYNOPSIS

#include <math.h>

long int lround(double x);

HP Integrity Server Only

long int lroundf(float x);

long int lroundl(long double x);

long int lroundw(extended x);

long int lroundq(quad x);

DESCRIPTION

lround() 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 llround.

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

Integrity Server Only

lroundf() is a float version of lround(); it takes a float argument.

lroundl() is a long double version of lround(); it takes a long double argument.

lroundw() is an extended version of lround(); it takes an extended argument.

lroundq() is equivalent to lroundl() 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 Integrity servers) lroundw() or lroundq(), 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 for HP Integrity servers at the following site: http://www.hp.com/go/fp.

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 floating-point exception is raised. On Integrity servers, if the rounded value is outside the range of long int, the numeric result is the minimum long int value.

When lround() 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

lround(), lroundf(), lroundl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.