fetestexcept(3M)					  Mathematical Library Functions					  fetestexcept(3M)

NAME

       fetestexcept - test floating-point exception flags

SYNOPSIS

       c99 [ flag... ] file... -lm [ library... ]
       #include <fenv.h>

       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  cur-
       rently set floating-point exceptions included in excepts.

ERRORS

       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 <fenv.h>
	 /* ... */
	 {
	 #     pragma STDC FENV_ACCESS ON
	       int set_excepts;
	       feclearexcept(FE_INVALID | FE_OVERFLOW);
	       // maybe raise exceptions
	       set_excepts = fetestexcept(FE_INVALID | FE_OVERFLOW);
	       if (set_excepts & FE_INVALID) f();
	       if (set_excepts & FE_OVERFLOW) g();
	       /* ... */
	 }

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.11							    12 Jul 2006 						  fetestexcept(3M)