Mathematical Library Functions                   fetestexcept(3M)



NAME
     fetestexcept - test floating-point exception flags

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

     int fetestexcept(int excepts);


DESCRIPTION
     The fetestexcept() function determines which of a  specified
     subset  of  the floating-point exception flags are currently
     set.  The  excepts  argument  specifies  the  floating-point
     status flags to be queried.

RETURN VALUES
     The  fetestexcept()  function  returns  the  value  of   the
     bitwise-inclusive  OR of the floating-point exception macros
     corresponding to the currently set floating-point exceptions
     included in excepts.

ERORS
     No errors are defined.

EXAMPLES
     Example 1 Example using fetestexcept()


     The following example calls function  f(  )  if  an  invalid
     exception  is  set,  and  then  function g( ) if an overflow
     exception is set:


       #include 
       /* ... */
       {
       #     pragma STDC FENVACES ON
             int setexcepts;
             feclearexcept(FEINVALID  FEOVERFLOW);
             / maybe raise exceptions
             setexcepts = fetestexcept(FEINVALID  FEOVERFLOW);
             if (setexcepts & FEINVALID) f();
             if (setexcepts & FEOVERFLOW) g();
             /* ... */
       }


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




SunOS 5.11          Last change: 12 Jul 2006                    1






Mathematical Library Functions                   fetestexcept(3M)



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


SEE ALSO
     feclearexcept(3M),    fegetexceptflag(3M),    fenv.h(3HEAD),
     attributes(5), standards(5)











































SunOS 5.11          Last change: 12 Jul 2006                    2