The feraiseexcept() function is defined in <cfenv> header file.
feraiseexcept() prototype
int feraiseexcept(int excepts);
The floating point exceptions to be raised are listed in the argument excepts.
Also, you should enable FENV_ACCESS, which will give your program to access the Floating point environment to test the exceptions raised.
feraiseexcept() Parameters
- excepts: Bitmask listing of exception flags to raise.
| Macro | Type | Description |
|---|---|---|
| FE_DIVBYZERO | Pole error | Division by zero |
| FE_INEXACT | Inexact | Not exact results such as (1.0/3.0) |
| FE_INVALID | Domain error | At least one arguments used is a value for which the function is not defined |
| FE_OVERFLOW | Overflow range error | Result is too large in magnitude to be represented by the return type |
| FE_UNDERFLOW | Underflow range error | Result is too small in magnitude to be represented by the return type |
| FE_ALL_EXCEPT | All exceptions | All exceptions supported by the implementation |
feraiseexcept() Return value
- The feraiseexcept() function returns zero value if all the exceptions specified by excepts are raised.
- Otherwise it returns a nonzero value.
Example: How feraiseexcept() function works
#include <iostream>
#include <fenv.h>
#pragma STDC FENV_ACCESS ON
using namespace std;
int main()
{
int retVal;
feclearexcept(FE_ALL_EXCEPT);
retVal = feraiseexcept(FE_OVERFLOW | FE_INVALID);
if (retVal == 0)
cout << "Successfully raised FE_OVERFLOW and FE_INVALID" << endl;
else
cout << "Raising FE_OVERFLOW and FE_INVALID failed" << endl;
return 0;
}
When you run the program, the output will be:
Successfully raised FE_OVERFLOW and FE_INVALID