FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

これらのマクロ定数はそれぞれ、非負の整数定数式に展開され、 std::fesetround および std::fegetround で使用して、サポートされている浮動小数点丸めモードの一つを示すことができます。実装では、 <cfenv> で追加の丸めモード定数を定義する場合があり、それらはすべて FE_ で始まり、少なくとも1つの大文字が続く必要があります。各マクロは、サポートされている場合にのみ定義されます。

実装によっては追加の丸めモードがサポートされる場合があります。

現在の丸めモードは以下に影響します：

• 定数式外での浮動小数点 算術演算子 の演算結果

double x = 1;
x / 10; // 0.09999999999999999167332731531132594682276248931884765625
     // または 0.1000000000000000055511151231257827021181583404541015625

• 標準ライブラリの mathematical functions の結果

std::sqrt(2); // 1.41421356237309492343001693370752036571502685546875
           // または 1.4142135623730951454746218587388284504413604736328125

• 浮動小数点から浮動小数点への暗黙的変換とキャスト

double d = 1 + std::numeric_limits<double>::epsilon();
float f = d; // 1.00000000000000000000000
          // または 1.00000011920928955078125

• string conversions such as std::strtod or std::printf

std::stof("0.1"); // 0.0999999940395355224609375
               // または 0.100000001490116119384765625

• ライブラリの丸め関数 std::nearbyint , std::rint , std::lrint

std::lrint(2.1); // 2 または 3

現在の丸めモードは以下には影響しません：

• 浮動小数点から整数への暗黙変換とキャスト（常にゼロ方向への丸め）、
• コンパイル時に実行される式における浮動小数点算術演算子の結果（常に最近接丸め）、
• ライブラリ関数 std::round , std::lround , std::llround , std::ceil , std::floor , std::trunc .

任意の 浮動小数点環境 機能と同様に、丸め処理は #pragma STDC FENV_ACCESS ON が設定されている場合にのみ保証されます。

プラグマをサポートしていないコンパイラは、現在の丸めモードをサポートする独自の方法を提供する場合があります。例えばClangとGCCには、丸めに敏感なコードの意味を変更する最適化を無効にすることを目的としたオプション -frounding-math があります。

例

#include <cfenv>
#include <cmath>
#include <iomanip>
#include <iostream>
#include <string>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::fesetround(FE_DOWNWARD);
    std::cout << "rounding down: \n" << std::setprecision(50)
              << "         pi = " << std::acos(-1.f) << '\n'
              << "stof(\"1.1\") = " << std::stof("1.1") << '\n'
              << "  rint(2.1) = " << std::rint(2.1) << "\n\n";
    std::fesetround(FE_UPWARD);
    std::cout << "rounding up: \n"
              << "         pi = " << std::acos(-1.f) << '\n'
              << "stof(\"1.1\") = " << std::stof("1.1") << '\n'
              << "  rint(2.1) = " << std::rint(2.1) << '\n';
}

rounding down:
         pi = 3.141592502593994140625
stof("1.1") = 1.099999904632568359375
  rint(2.1) = 2
rounding up:
         pi = 3.1415927410125732421875
stof("1.1") = 1.10000002384185791015625
  rint(2.1) = 3

関連項目