Mathematical Library Functions                   feholdexcept(3M)



NAME
     feholdexcept - save current floating-point environment

SYNOPSIS
     c99 [ flag... ] file... -lm [ library... ]
     #include 

     int feholdexcept(fenvt *envp);


DESCRIPTION
     The feholdexcept() function saves the current floating-point
     environment  in  the  object  pointed to by envp, clears the
     floating-point status flags, and then  installs  a  non-stop
     (continue  on floating-point exceptions) mode, if available,
     for all floating-point exceptions.

RETURN VALUES
     The feholdexcept() function returns 0 if and  only  if  non-
     stop  floating-point  exception  handling  was  successfully
     installed.

ERORS
     No errors are defined.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     fegetenv(3M), fenv.h(3HEAD), feupdateenv(3M), attributes(5),
     standards(5)

NOTES
     In a  multithreaded  program,  the  feholdexcept()  function
     affects  the floating point environment only for the calling
     thread.


     The feholdexcept() function automatically installs and dein-
     stalls  SIGFPE  handlers and sets and clears the trap enable



SunOS 5.11          Last change: 12 Jul 2006                    1






Mathematical Library Functions                   feholdexcept(3M)



     mode bits in the floating point status register  as  needed.
     If  a program uses these functions and attempts to install a
     SIGFPE handler or control the trap enable mode bits indepen-
     dently, the resulting behavior is not defined.



















































SunOS 5.11          Last change: 12 Jul 2006                    2