frexpd64.3m (2010 09)

f
frexpd64(3M) frexpd64(3M)
(HP Integrity Server Only)
NAME
frexpd64(), frexpd128(), frexpd32() - extract mantissa and exponent from decimal floating-point numbers
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <math.h>
_Decimal64 frexpd64(_Decimal64 value, int *exp);
_Decimal128 frexpd128(_Decimal128 value, int *exp);
_Decimal32 frexpd32(_Decimal32 value, int *exp);
DESCRIPTION
The frexpd64() function breaks a decimal floating-point number into a normalized decimal fraction f
and an integral power of 10. It returns f and stores the integer exponent of 10 in the
int object pointed
to by exp. The fraction f is a
_Decimal64 with magnitude in the interval [0.1, 1) or zero, and value
equals f times 10 raised to the power *exp .
frexpd128() is a _Decimal128 version of frexpd64(); it takes a
_Decimal128 first argument
and returns a
_Decimal128 result.
frexpd32() is a _Decimal32 version of frexpd64(); 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 value is zero,
frexpd64() returns value and stores zero in the object pointed to by exp .
If value is NaN,
frexpd64() returns NaN, and the value of *exp is unspecified.
If value is ±infinity,
frexpd64() returns value , and the value of *exp is unspecified.
These functions raise no exceptions.
ERRORS
No errors are defined.
SEE ALSO
ilogbd64(3M), ldexpd64(3M), logbd64(3M), modfd64(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