scalblnd64.3m (2010 09)

s
scalblnd64(3M) scalblnd64(3M)
(HP Integrity Server Only)
NAME
scalblnd64(), scalblnd128(), scalblnd32() - scale exponent of a decimal floating-point number
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <math.h>
_Decimal64 scalblnd64(_Decimal64 x, long int exp);
_Decimal128 scalblnd128(_Decimal128 x, long int exp);
_Decimal32 scalblnd32(_Decimal32 x, long int exp);
DESCRIPTION
The scalblnd64() function computes the quantity x *10
exp
.
scalblnd64() is equivalent to scalbnd64(), except the second parameter has type
long int
instead of int.
scalblnd128()
is a _Decimal128 version of scalblnd64(); it takes a _Decimal128
first argu-
ment and returns a
_Decimal128 result.
scalblnd32() is a _Decimal32 version of scalblnd64(); 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,
scalblnd64() returns x.
If x is NaN,
scalblnd64() returns NaN.
scalblnd64() 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.
scalblnd64() raises the underflow and inexact exceptions whenever a result is tiny (essentially sub-
normal or zero) and inexact.
ERRORS
If the correct value would overflow,
scalblnd64() sets errno to [ERANGE].
SEE ALSO
frexpd64(3M), ilogbd64(3M), ldexpd64(3M), logbd64(3M), scalbnd64(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