Namespaces
Variants

FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

From cppreference.net
< c ‎ | numeric ‎ | fenv
定义于头文件 <fenv.h>
#define FE_DOWNWARD /*implementation defined*/
(C99 起)
#define FE_TONEAREST /*implementation defined*/
(C99 起)
#define FE_TOWARDZERO /*implementation defined*/
(C99 起)
#define FE_UPWARD /*implementation defined*/
(C99 起)

这些宏常量各自展开为一个非负整数常量表达式,可用于 fesetround fegetround 以指示支持的浮点舍入模式之一。实现可以在 <fenv.h> 中定义额外的舍入模式常量,这些常量都应以 FE_ 开头,后跟至少一个大写字母。每个宏仅在其受支持时被定义。

常量 说明
FE_DOWNWARD 向负无穷大方向舍入
FE_TONEAREST 向最接近的可表示值舍入
FE_TOWARDZERO 向零方向舍入
FE_UPWARD 向正无穷大方向舍入

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

当前舍入模式影响以下内容:

  • 非常量表达式中浮点算术运算符的结果
double x = 1;
x / 10; // 0.09999999999999999167332731531132594682276248931884765625 或
        // 0.1000000000000000055511151231257827021181583404541015625
sqrt(2); // 1.41421356237309492343001693370752036571502685546875 或
         // 1.4142135623730951454746218587388284504413604736328125
  • 浮点数到浮点数的隐式转换与显式转换
double d = 1 + DBL_EPSILON;
float f = d; // 1.00000000000000000000000 或
             // 1.00000011920928955078125
strtof("0.1", NULL); // 0.0999999940395355224609375 或
                     // 0.100000001490116119384765625
lrint(2.1); // 2 或 3

当前舍入模式不会影响以下内容:

  • 浮点数到整数的隐式转换和强制转换(始终向零取整)
  • 编译时执行的常量表达式中浮点算术运算符的结果(始终四舍五入到最接近值)
  • 库函数 round , lround , llround , ceil , floor , trunc

与任何 浮点环境 功能一样,仅当设置了 #pragma STDC FENV_ACCESS ON 时才能保证舍入行为。

不支持该编译指示的编译器可能会提供自己的方式来支持当前舍入模式。例如 Clang 和 GCC 提供了 -frounding-math 选项,旨在禁用可能改变舍入敏感代码含义的优化。

示例

#include <fenv.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
// #pragma STDC FENV_ACCESS ON
int main()
{
    fesetround(FE_DOWNWARD);
    puts("rounding down: ");
    printf("           pi = %.22f\n", acosf(-1));
    printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL));
    printf("    rint(2.1) = %.22f\n\n", rintf(2.1));
    fesetround(FE_UPWARD);
    puts("rounding up: ");
    printf("           pi = %.22f\n", acosf(-1));
    printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL));
    printf("    rint(2.1) = %.22f\n", rintf(2.1));
}

输出:

rounding down:
           pi = 3.1415925025939941406250
strtof("1.1") = 1.0999999046325683593750
    rint(2.1) = 2.0000000000000000000000
rounding up:
           pi = 3.1415927410125732421875
strtof("1.1") = 1.1000000238418579101563
    rint(2.1) = 3.0000000000000000000000

参考文献

  • C23 标准 (ISO/IEC 9899:2024):
  • 7.6/8 浮点环境 <fenv.h> (页码: 待定)
  • C17 标准 (ISO/IEC 9899:2018):
  • 7.6/8 浮点环境 <fenv.h> (页: 151)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.6/8 浮点环境 <fenv.h> (页码: 207)
  • C99标准(ISO/IEC 9899:1999):
  • 7.6/7 浮点环境 <fenv.h>(页码:188)

参见

获取或设置浮点数舍入方向
(函数)
C++ 文档 关于 浮点数舍入宏