feraiseexcept(3M)

Name

feraiseexcept - raise floating-point exception

Synopsis

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

int feraiseexcept(int excepts);

Description

The feraiseexcept() function attempts to raise the supported floating-point exceptions represented by the excepts argument. The order in which these floating-point exceptions are raised is unspecified.

Return Values

If excepts is 0 or if all the specified exceptions were successfully raised, feraiseexcept() returns 0. Otherwise, it returns a non-zero value.

Errors

No errors are defined.

Usage

The effect is intended to be similar to that of floating-point exceptions raised by arithmetic operations. Hence, enabled traps for floating-point exceptions raised by this function are taken.

Attributes

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

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level MT-Safe Standard See standards(5).

See also

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