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
fesetexceptflag(3M) fesetexceptflag(3M)
NAME
fesetexceptflag() - set floating-point exception flags
SYNOPSIS
#include <fenv.h>
void fesetexceptflag(const fexcept_t *flagp, int excepts);
DESCRIPTION
The fesetexceptflag() function sets the status for the exception flags indicated by the argument
excepts according to the representation in the object pointed to by flagp. The value of *flagp must have
been set by a previous call to fegetexceptflag(); otherwise, the effect on the indicated exception
flags is undefined. This function does not raise exceptions, but only sets the state of the flags. The excepts
argument can be constructed as a bitwise OR of the exception macros: FE_INEXACT, FE_DIVBYZERO ,
FE_UNDERFLOW , FE_OVERFLOW , and FE_INVALID . FE_ALL_EXCEPT represents all the exceptions.
The ISO/ANSI C committee has approved the fesetexceptflag() 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
None.
ERRORS
No errors are defined.
EXAMPLE
Use
fegetexceptflag()
to save the current state of two exception flags. Later, use fesetex-
ceptflag()
to restore the saved state.
#include <fenv.h>
/*...*/
fexcept_t saved_flags;
/*...*/
fegetexceptflag(&saved_flags, FE_DIVBYZERO | FE_INEXACT);
/*...*/
fesetexceptflag(&saved_flags, FE_DIVBYZERO | FE_INEXACT);
SEE ALSO
feclearexcept(3M), fegetexceptflag(3M), fegettrapenable(3M), feraiseexcept(3M), fesettrapenable(3M),
fetestexcept(3M), fenv(5).
Section 3230 1 HP-UX Release 11i: December 2000
___
___