_decodebinary64.3m (2010 09)

_
_decodebinary64(3M) _decodebinary64(3M)
(HP Integrity Server Only)
NAME
_decodebinary64(), _decodebinary128(), _decodebinary32() - decode binary-encoded decimal data
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <math.h>
_Decimal64 _decodebinary64(_Binaryencoding64 x);
_Decimal128 _decodebinary128(_Binaryencoding128 x);
_Decimal32 _decodebinary32(_Binaryencoding32 x);
DESCRIPTION
There are two standard bit-encodings for decimal floating-point data: binary and decimal . Both encod-
ings provide exactly the same data (analogous to big endian and little endian encodings). The HP-UX
decimal floating-point types use the binary encoding.
The
_decodebinary64()
function decodes x, interpreted as a binary-encoded 64-bit decimal datum,
into the encoding for
_Decimal64.
_decodebinary128()
is a _Decimal128 version of _decodebinary64()
; it takes a
_Binaryencoding128
argument and returns a _Decimal128 result.
_decodebinary32()
is a _Decimal32 version of _decodebinary64(); it takes a _Binaryen-
coding32 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
_decodebinary64()
returns x in the encoding for _Decimal64.
_decodebinary64()
raises no exceptions.
ERRORS
No errors are defined.
SEE ALSO
_decodedecimal64(3M), _encodebinary64(3M), _encodedecimal64(3M, math(5).
STANDARDS CONFORMANCE
These functions are not specified in any standard.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1