Manualshelf

fe_dec_setround.3m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
f
fe_dec_setround(3M) fe_dec_setround(3M)
NAME
fe_dec_setround( ) - set decimal floating-point rounding direction mode
SYNOPSIS
#define __STDC_WANT_DEC_FP__
#include <fenv.h>
int fe_dec_setround(int round);
DESCRIPTION
The fe_dec_setround()
function establishes the decimal rounding direction represented by its argu-
ment round. The round argument must equal one of the macros (defined in
<fenv.h>):
FE_DEC_TONEAREST
, FE_DEC_TONEARESTFROMZERO
,
FE_DEC_UPWARD, FE_DEC_DOWNWARD
, and
FE_TOWARDZERO
. If the argument does not match a decimal rounding direction macro, the decimal
rounding direction is not changed.
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_setround()
function returns a zero value if and only if the argument is equal to a
decimal rounding direction macro.
SEE ALSO
fe_dec_getround(3M), fenv(5).
STANDARDS CONFORMANCE
This function conforms 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

Summary of content (2 pages)