# std::feholdexcept

> C++ Atlas: `cppatlas.com/w/cpp/numeric/fenv/feholdexcept` | Source: https://en.cppreference.com/w/cpp/numeric/fenv/feholdexcept | Domain: Numerics | Standards: C++11

First, saves the current floating-point environment to the object pointed to by envp (similar to std::fegetenv), then clears all floating-point status flags, and then installs the non-stop mode: future floating-point exceptions will not…

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cfenv>
int feholdexcept( std::fenv_t* envp ) // (since C++11)
```

First, saves the current floating-point environment to the object pointed to by `envp` (similar to `std::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 `std::feupdateenv` or `std::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 `std::feupdateenv` after clearing the unwanted exceptions.

### Parameters

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

### Return value

`​0​` on success, non-zero otherwise.

### See also

- [`feupdateenv`](https://en.cppreference.com/w/cpp/numeric/fenv/feupdateenv) (C++11): restores the floating-point environment and raises the previously raised exceptions (function)
- [`fegetenv`](https://en.cppreference.com/w/cpp/numeric/fenv/feenv) (C++11), [`fesetenv`](https://en.cppreference.com/w/cpp/numeric/fenv/feenv): saves or restores the current floating-point environment (function)
- [`FE_DFL_ENV`](https://en.cppreference.com/w/cpp/numeric/fenv/FE_DFL_ENV) (C++11): default floating-point environment (macro constant)
- [C documentation for `feholdexcept`](https://en.cppreference.com/w/c/numeric/fenv/feholdexcept)

---
Attribution: content from https://en.cppreference.com/w/cpp/numeric/fenv/feholdexcept (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.