fe_tonearest.md

FE_TONEAREST

• cfenv[meta header]
• macro[meta id-type]
• cpp11[meta cpp]

# define FE_TONEAREST implementation-defined

概要

浮動小数点数の丸め方式として、「最も近い値への丸め (round to nearest)」を表すマクロ。

この丸め方式は、最も近い整数方向に対して丸める。四捨五入と異なるところは、中間値(0.5)の場合は、偶数方向に丸められることである。このような方式は「最近接偶数への丸め」「銀行丸め」」「JIS丸め」「ISO丸め」「bankers’ rounding」など、いろいろな呼ばれ方がされる。

このマクロは、標準ライブラリの丸め処理で使用される丸め方式をユーザーが選択するために使用する。

このマクロの値は、整数の定数式として定義され、非負の値を持つ。

備考

FE_TONEARESTは実装として、以下がありえる:

1. 中間値の場合に、偶数方向へ丸める (「最近接偶数への丸め」「to nearest, ties to even」「JIS丸め」「ISO丸め」「bankers’ rounding」)
2. 中間値の場合に、ゼロから遠い方向へ丸める (「四捨五入」「to nearest, ties away from zero」)

標準C++の規格では、この動作はIEC 60559 (IEEE 754)にゆだねている。そして、IEC 60559では、デフォルトが1. の「偶数方向への丸め」となっている(実装に推奨されている)。そのため、IEC 60559の推奨に従っている処理系では、FE_TONEARESTの動作は「最近接偶数への丸め」となるだろう。

例

#include <iostream>
#include <cfenv>
#include <cmath>

int main()
{
  std::fesetround(FE_TONEAREST);

  float ar[] = {
      2.0,  2.1,  2.5,  2.9,
     -2.0, -2.1, -2.5, -2.9
  };

  for (float f : ar) {
    int x = std::nearbyint(f);
    std::cout << f << " -> " << x << std::endl;
  }
}

• FE_TONEAREST[color ff0000]
• std::fesetround[link fesetround.md]
• std::nearbyint[link /reference/cmath/nearbyint.md]

出力

2 -> 2
2.1 -> 2
2.5 -> 2
2.9 -> 3
-2 -> -2
-2.1 -> -2
-2.5 -> -2
-2.9 -> -3

バージョン

言語

• C++11

処理系

• Clang, C++11 mode: 3.0
• GCC, C++11 mode: 4.3.0
• ICC: ??
• Visual C++: 2013, 2015
  • コンパイルオプション/fp:strictまたは#pragma fenv_access (on)が必要。さもなくば、正しく動作しないおそれがある。