FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

数值库

常用数学函数

数学特殊函数 (C++17)

数学常数 (C++20)

浮点环境 (C++11)

复数

数值数组

伪随机数生成

因数运算

gcd (C++17)

lcm (C++17)

插值

midpoint (C++20)

lerp (C++20)

泛型数值运算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

位操作

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

浮点环境

函数

feclearexcept (C++11)

fetestexcept (C++11)

feraiseexcept (C++11)

fegetexceptflagfesetexceptflag (C++11)(C++11)

fegetroundfesetround (C++11)(C++11)

fegetenvfesetenv (C++11)(C++11)

feholdexcept (C++11)

feupdateenv (C++11)

宏常量

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)

FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C++11)(C++11)(C++11)(C++11)

FE_DFL_ENV (C++11)

 

在标头 <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	指示浮点舍入模式 (枚举)
fegetroundfesetround (C++11)(C++11)	获取或设置舍入方向 (函数)