scalbnd64.3m (2010 09)

s
scalbnd64(3M) scalbnd64(3M)
(HP Integrity Server Only)
NAME
scalbnd64(), scalbnd128(), scalbnd32() - scale exponent of a decimal floating-point number
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <math.h>
_Decimal64 scalbnd64(_Decimal64 x, int exp);
_Decimal128 scalbnd128(_Decimal128 x, int exp);
_Decimal32 scalbnd32(_Decimal32 x, int exp);
DESCRIPTION
The scalbnd64() function computes the quantity x *10
exp
.
scalbnd64() is equivalent to ldexpd64().
scalbnd64() is equivalent to scalblnd64(), except the second parameter has type
int instead of
long int.
scalbnd128() is a _Decimal128 version of scalbnd64(); it takes a
_Decimal128 first argu-
ment and returns a
_Decimal128 result.
scalbnd32() is a _Decimal32 version of scalbnd64(); it takes a _Decimal32 first 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 zero,
scalbnd64() returns x.
If x is NaN,
scalbnd64() returns NaN.
scalbnd64() returns the properly signed infinity (or, in some non-default rounding direction modes,
the properly signed maximum-magnitude finite number) in lieu of a value whose magnitude is too large,
and raises the overflow and inexact exceptions.
scalbnd64() raises the underflow and inexact exceptions whenever a result is tiny (essentially subnor-
mal or zero) and inexact.
ERRORS
If the correct value would overflow,
scalbnd64() sets errno to [ERANGE].
SEE ALSO
frexpd64(3M), ilogbd64(3M), ldexpd64(3M), logbd64(3M), scalblnd64(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