Namespaces
Variants
Views
Actions

feholdexcept

From cppreference.com
< c‎ | numeric‎ | fenv
Revision as of 20:21, 2 November 2012 by P12bot (Talk | contribs)

Template:ddcl list begin <tr class="t-dsc-header">

<td>
Defined in header <<fenv.h>>
</td>

<td></td> <td></td> <tr class="t-dcl ">

<td >
int feholdexcept( fenv_t* envp );
</td>

<td class="t-dcl-nopad"> </td> <td > (since C99) </td> </tr> Template:ddcl list end

First, saves the current floating-point environment to the object pointed to by envp (similar to fegetenv), then clears all floating-point status flags, and then installs the non-stop mode: future floating-point exceptions will not interrupt execution (will not trap), until the floating-point environment is restored by feupdateenv or fesetenv.

This function may be used in the beginning of a subroutine that must hide the floating-point exceptions it may raise from the caller. If only some exceptions must be suppressed, while others must be reported, the non-stop mode is usually ended with a call to feupdateenv after clearing the unwanted exceptions.

Contents

Parameters

envp - pointer to the object of type fenv_t where the floating-point environment will be stored

Return value

0 on success, non-zero otherwise.

Example

See also

Template:c/numeric/fenv/dcl list feupdateenvTemplate:c/numeric/fenv/dcl list feenvTemplate:c/numeric/fenv/dcl list FE DFL ENV
C++ documentation for feholdexcept