std::fegetround, std::fesetround
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Numerics library
Mathematical special functions (C++17)
Mathematical constants (C++20)
Basic linear algebra algorithms (C++26)
Data-parallel types (SIMD) (C++26)
Floating-point environment (C++11)
Bit manipulation (C++20)
Saturation arithmetic (C++26)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
Floating-point environment
Functions
(C++11)
(C++11)
(C++11)
(C++11)(C++11)
fegetroundfesetround
(C++11)(C++11)
(C++11)(C++11)
(C++11)
(C++11)
Macro constants
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)
Defined in header
<cfenv>
int fesetround( int round )
(1)
(since C++11)
int fegetround()
(2)
(since C++11)
Manages the floating-point rounding direction.
1) Attempts to establish the floating-point rounding direction equal to the argument
round
, which is expected to be one of the floating point rounding macros. 2) Returns the value of the floating point rounding macro that corresponds to the current rounding direction.
Contents
[edit] Parameters
round
-
rounding direction, one of floating point rounding macros
[edit] Return value
1) 0 on success, non-zero otherwise.
2) The floating point rounding macro describing the current rounding direction or a negative value if the direction cannot be determined.
[edit] Notes
The current rounding mode, reflecting the effects of the most recent fesetround
, can also be queried with FLT_ROUNDS .
See floating-point rounding macros for the effects of rounding.
[edit] Example
Run this code
#include <cfenv> #include <cmath> #include <iomanip> #include <iostream> #include <utility> // #pragma STDC FENV_ACCESS ON int main() { static constexpr std::pair <const char*, const double> samples[] { {" 12.0", 12.0}, {" 12.1", 12.1}, {"-12.1", -12.1}, {" 12.5", 12.5}, {"-12.5", -12.5}, {" 12.9", 12.9}, {"-12.9", -12.9}, {" 13.0", 13.0} }; std::cout << "│ sample │ FE_DOWNWARD │ FE_UPWARD │ FE_TONEAREST │ FE_TOWARDZERO │\n"; for (const auto& [str, fp] : samples) { std::cout << "│ " << std::setw (6) << str << " │ "; for (const int dir : {FE_DOWNWARD, FE_UPWARD, FE_TONEAREST, FE_TOWARDZERO }) { std::fesetround(dir); std::cout << std::setw (10) << std::fixed << std::nearbyint (fp) << " │ "; } std::cout << '\n'; } }
Output:
│ sample │ FE_DOWNWARD │ FE_UPWARD │ FE_TONEAREST │ FE_TOWARDZERO │ │ 12.0 │ 12.000000 │ 12.000000 │ 12.000000 │ 12.000000 │ │ 12.1 │ 12.000000 │ 13.000000 │ 12.000000 │ 12.000000 │ │ -12.1 │ -13.000000 │ -12.000000 │ -12.000000 │ -12.000000 │ │ 12.5 │ 12.000000 │ 13.000000 │ 12.000000 │ 12.000000 │ │ -12.5 │ -13.000000 │ -12.000000 │ -12.000000 │ -12.000000 │ │ 12.9 │ 12.000000 │ 13.000000 │ 13.000000 │ 12.000000 │ │ -12.9 │ -13.000000 │ -12.000000 │ -13.000000 │ -12.000000 │ │ 13.0 │ 13.000000 │ 13.000000 │ 13.000000 │ 13.000000 │
[edit] See also
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
exception if the result differs
(function) [edit]
C documentation for fegetround, fesetround