Manualshelf

rintd64.3m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
r
rintd64(3M) rintd64(3M)
(HP Integrity Server Only)
NAME
rintd64(), rintd128(), rintd32() - decimal round to nearest integer functions
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <math.h>
_Decimal64 rintd64(_Decimal64 x);
_Decimal128 rintd128(_Decimal128 x);
_Decimal32 rintd32(_Decimal32 x);
DESCRIPTION
rintd64() returns the integer (represented as a _Decimal64
number) nearest x according to the
current (decimal) rounding direction mode.
In the default rounding direction (round to nearest with ties to even),
rintd64(x) is the integer nearest
x with the additional stipulation that if |
rintd64(x) − x|=1/2, then rintd64(x) is even.
If the current rounding direction is toward negative infinity,
rintd64() returns the same value as
floord64(). If the current rounding direction is toward positive infinity,
rintd64() returns the
same value as
ceild64(). If the current rounding direction is toward zero, rintd64() returns the
same value as truncd64(). If the current rounding direction is to nearest with ties awary from zero,
rintd64() returns the same value as roundd64().
rintd64() differs from nearbyintd64()
only in that rintd64() raises the inexact exception if
the result differs in value from the argument, while
nearbyintd64()
does not.
rintd128() is a _Decimal128 version of rintd64(); it takes a _Decimal128 argument and
returns a _Decimal128 result.
rintd32() is a _Decimal32 version of rintd64(); it takes a _Decimal32 argument and returns a
_Decimal32 result.
These math functions are supported for HP-UX 11i Version 3 September 2008 Update and forward.
USAGE
To use any of these functions, compile with the +decfp option.
Make sure your program defines
__STDC_WANT_DEC_FP__
and then includes <math.h>.
Link in the math library by specifying
-lm or -l:libm.a on the linking 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 x is ±infinity or ±0,
rintd64() returns x.
If x is NaN,
rintd64() returns NaN.
rintd64() raises the inexact exception if the result differs in value from the argument.
ERRORS
No errors are defined.
SEE ALSO
ceild64(3M), fabsd64(3M), fe_dec_getround(3M), fe_dec_setround(3M), floord64(3M), fmodd64(3M),
nearbyintd64(3M), llrintd64(3M), lrintd64(3M), roundd64(3M), truncd64(3M), math(5).
STANDARDS CONFORMANCE
These functions conform to ISO/IEC TR 24732, "Extension for the programming language C to support
decimal floating-point arithmetic".
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)