Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

feholdexcept(3) Guardian Native C Library Calls Reference Manual
NAME
feholdexcept - Saves the floating-point environment
LIBRARY
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll
SYNOPSIS
#include <fenv.h>
int feholdexcept(
fenv_t *envp);
PARAMETERS
envp Specifies the object that is to store the current floating-point environment.
DESCRIPTION
The feholdexcept() function saves the current floating-point environment in the object pointed to
by the parameter envp. This function also clears the floating-point status flags and then installs a
non-stop (continue on floating-point exceptions) mode, if available, for all floating-point excep-
tions.
The feholdexcept() function can be used with the feupdatenv() function to hide spurious
floating-point exceptions from a call.
The feholdexcept() function can be used with the fesetenv( ) function to hide all floating-point
exceptions.
NOTES
This function is implemented only for the IEEE_float floating-point option. Applications using
this function cannot be compiled if the specified floating-point option is Tandem_float.
RETURN VALUES
The feholdexcept() function always returns 0 (zero), indicating the successful disabling of any
traps.
RELATED INFORMATION
Functions: fegetenv(3), fesetenv(3), feupdateenv(3).
STANDARDS CONFORMANCE
This function conforms to the ISO/IEC 9899:1999 standard.
This function conforms to the IEEE Std 1003.1, 2004 Edition.
2−18 Hewlett-Packard Company 527192-018