# FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

< cpp‎ | numeric‎ | fenv

定义于头文件 `<cfenv>` |  |
#define FE_DOWNWARD /*implementation defined*/ |  | (C++11 起)
#define FE_TONEAREST /*implementation defined*/ |  | (C++11 起)
#define FE_TOWARDZERO /*implementation defined*/ |  | (C++11 起)
#define FE_UPWARD /*implementation defined*/ |  | (C++11 起)

每个这种宏展开成非负常量表达式，可被 std::fesetround 或 std::fegetround 用于指示受支持的浮点舍入模式之一。实现可于 `<cfenv>` 定义另外的舍入模式常量，它应以 `FE_` 后随至少一个大写字母开始。每个宏仅若受支持才得到定义。

大多数实现中，这些宏常量展开成的值等于 FLT_ROUNDS 和 std::float_round_style 的值。

常量 | 解释
`FE_DOWNWARD` | 向负无穷大舍入
`FE_TONEAREST` | 向最接近可表示值舍入
`FE_TOWARDZERO` | 向零舍入
`FE_UPWARD` | 向正无穷大舍入

实现可支持另外的舍入模式。

当前舍入模式影响下列内容：

- 常量表达式外浮点算术运算符的结果

    double x = 1;
    x/10; // 0.09999999999999999167332731531132594682276248931884765625
       // or 0.1000000000000000055511151231257827021181583404541015625

- 标准库数学函数的结果

    std::sqrt(2); // 1.41421356237309492343001693370752036571502685546875
               // or 1.4142135623730951454746218587388284504413604736328125

- 浮点到浮点隐式转换或转型

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

- 例如 std::strtod 或 std::printf 的字符串转换

    std::stof("0.1"); // 0.0999999940395355224609375
                   // or 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` 才保证舍入。

### 示例

    #include <iostream>
    #include <iomanip>
    #include <string>
    #include <cfenv>
    #include <cmath>
    int main()
    {
    #pragma STDC FENV_ACCESS ON
        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.3) << "\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.3) << '\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

### 参阅

float_round_style | 指示浮点舍入模式 (枚举)
fegetround fesetround (C++11)(C++11) | 获取或设置舍入方向 (函数)