1FEHOLDEXCEPT(3P)           POSIX Programmer's Manual          FEHOLDEXCEPT(3P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       feholdexcept - save current floating-point environment
13

SYNOPSIS

15       #include <fenv.h>
16
17       int feholdexcept(fenv_t *envp);
18
19

DESCRIPTION

21       The feholdexcept() function shall save the current floating-point envi‐
22       ronment in the object pointed to by envp, clear the floating-point sta‐
23       tus flags, and then install  a  non-stop  (continue  on  floating-point
24       exceptions) mode, if available, for all floating-point exceptions.
25

RETURN VALUE

27       The  feholdexcept()  function shall return zero if and only if non-stop
28       floating-point exception handling was successfully installed.
29

ERRORS

31       No errors are defined.
32
33       The following sections are informative.
34

EXAMPLES

36       None.
37

APPLICATION USAGE

39       None.
40

RATIONALE

42       The  feholdexcept()   function   should   be   effective   on   typical
43       IEC 60559:1989 standard implementations which have the default non-stop
44       mode and at least one other mode for trap handling or aborting. If  the
45       implementation  provides  only  the  non-stop mode, then installing the
46       non-stop mode is trivial.
47

FUTURE DIRECTIONS

49       None.
50

SEE ALSO

52       fegetenv(), fesetenv(), feupdateenv(), the Base Definitions  volume  of
53       IEEE Std 1003.1-2001, <fenv.h>
54

56       Portions  of  this text are reprinted and reproduced in electronic form
57       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
58       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
59       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
60       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
61       event of any discrepancy between this version and the original IEEE and
62       The  Open Group Standard, the original IEEE and The Open Group Standard
63       is the referee document. The original Standard can be  obtained  online
64       at http://www.opengroup.org/unix/online.html .
65
66
67
68IEEE/The Open Group                  2003                     FEHOLDEXCEPT(3P)
Impressum