Manualshelf

fe_dec_getround.3m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
f
fe_dec_getround(3M) fe_dec_getround(3M)
NAME
fe_dec_getround( ) - get decimal floating-point rounding direction mode
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <fenv.h>
int fe_dec_getround(void);
DESCRIPTION
The fe_dec_getround()
function gets the current decimal rounding direction.
The default decimal rounding direction mode is round to nearest with half-way cases away from zero
(
FE_DEC_TONEAREST
).
These math functions are supported for HP-UX 11i Version 3 September 2008 Update and forward.
USAGE
To use this function, compile with the
+decfp option.
Make sure your program defines
__STDC_WANT_DEC_FP__
and then includes <fenv.h>.
Specify
+Ofenvaccess on the compiler command line or place the call to this function under the effect
of an affirmative FENV_ACCESS pragma:
#pragma STDC FENV_ACCESS ON
If the FENV_ACCESS pragma is placed outside of any top-level declarations in a file, the pragma will
apply until another FENV_ACCESS pragma is encountered or until the end of the file is reached.
If the
FENV_ACCESS pragma is placed at the beginning of a block (compound statement), the pragma
will apply until another FENV_ACCESS pragma is encountered or until the end of the block is reached.
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
The
fe_dec_getround()
function returns the value of the decimal rounding direction macro
representing the current decimal rounding direction. The return value will match one of the following
macros, which are defined in
<fenv.h>:
FE_DEC_TONEAREST
Round to nearest. If the two nearest representable are equally near, the one
with its least significant bit zero is delivered.
FE_DEC_TONEARESTFROMZERO
Round to nearest. If the two nearest representable are equally near, the one
furthest from zero is delivered.
FE_DEC_UPWARD Round upwards (towards +infinity).
FE_DEC_DOWNWARD
Round downwards (towards -infinity).
FE_DEC_TOWARDZERO
Round toward zero.
ERRORS
No errors are defined.
EXAMPLES
Save, set, and restore the decimal rounding direction.
#define __STDC_WANT_DEC_FP__
#include <fenv.h>
/*...*/
{
int save_round;
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)