ldexpd64.3m (2010 09)

f
ldexpd64(3M) ldexpd64(3M)
(HP Integrity Server Only)
NAME
ldexpd64(), ldexpd128(), ldexpd32() - scale exponent of a decimal floating-point number
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <math.h>
_Decimal64 ldexpd64(_Decimal64 x, int exp);
_Decimal128 ldexpd128(_Decimal128 x, int exp);
_Decimal32 ldexpd32(_Decimal32 x, int exp);
DESCRIPTION
The ldexpd64() function computes the quantity x *10
exp
.
ldexpd64() computes the same value as scalbnd64().
ldexpd128() is a _Decimal128 version of ldexpd64(); it takes a
_Decimal128 first argument
and returns a
_Decimal128 result.
ldexpd32() is a _Decimal32 version of ldexpd64(); 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,
ldexpd64() returns x.
If x is NaN,
ldexpd64() returns NaN.
ldexpd64() 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.
ldexpd64() 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,
ldexpd64() sets errno to [ERANGE].
SEE ALSO
frexpd64(3M), ilogbd64(3M), logbd64(3M), scalblnd64(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