fesetenv(3M)

DESCRIPTION

The fesetenv() function establishes the floating-point environment represented by the object pointed to by envp. The argument envp must point to an object set by a call to fegetenv() or feholdexcept(), or equal the macro FE_DFL_ENV.

Note that fesetenv() merely installs the state of the floating-point exception flags represented through its argument, and does not raise these floating-point exceptions (hence no traps will be taken).

USAGE

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>.

For Itanium-based systems, specify +Ofenvaccess on the compiler command line or place the call to this function under the effect of an affirmative FENV_ACCESS pragma:

If the FENV_ACCESS pragma is placed outside of any top-level declarations in a file, the pragma will apply to all declarations in the compilation following the pragma 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.

For PA-RISC, you might need to use the +Onomoveflops compiler option in order to prevent optimizations that can undermine the specified behavior of this function.

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

ERRORS

No errors are defined.

EXAMPLES

Store the current floating-point environment, continue on exceptions, and then restore the previous environment without raising the accumulated floating-point exceptions.

Restore the default environment:

SEE ALSO

fegetenv(3M), feholdexcept(3M), feupdateenv(3M), fenv(5).

STANDARDS CONFORMANCE

fesetenv() : ISO/IEC C99 (including Annex F, "IEC 60559 floating-point arithmetic")