HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
f
fesetround(3M) fesetround(3M)
NAME
fesetround() - set floating-point rounding direction mode
SYNOPSIS
#include <fenv.h>
int fesetround(int round);
DESCRIPTION
The fesetround() function establishes the rounding direction represented by its argument round. The
round argument must equal one of the macros FE_TONEAREST , FE_UPWARD, FE_DOWNWARD , and
FE_TOWARDZERO. If the argument does not match a rounding direction macro, the rounding direction is
not changed.
The default rounding direction mode is round to nearest (FE_TONEAREST ).
The ISO/ANSI C committee has approved the fesetround() function for inclusion in the C9X draft
standard.
To use this function, compile either with the default
-Ae option or with the -Aa and -D_HPUX_SOURCE
options. Make sure your program includes <fenv.h
>. Link in the math library by specifying -lm on the
compiler or linker command line.
For more information, see the HP-UX Floating-Point Guide.
RETURN VALUE
The
fesetround() function returns a zero value if and only if the argument is equal to a rounding
direction macro.
ERRORS
No errors are defined.
EXAMPLE
Save, set, and restore the rounding direction.
#include <fenv.h>
/*...*/
{
int save_round;
save_round = fegetround();
fesetround(FE_UPWARD);
/*...*/
fesetround(save_round);
/*...*/
}
SEE ALSO
fegetround(3M), fenv(5).
Section 3−−232 − 1 − HP-UX Release 11i: December 2000
___
___