C 参考手册

位置:首页 > C 参考手册 >数值 >浮点环境 > FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

定义于头文件 <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 起)

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

大多数实现中,这些宏常量的展开值等于 FLT_ROUNDSfloat_round_style 的值。

 
常量 解释
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

当前舍入模式不影响:

  • 浮点到整数的隐式转换或转型(始终向零)
  • 编译时执行的常量表达式中浮点算术运算符的结果(始终向最接近)
  • 库函数 roundlroundllroundceilfloortrunc

同任何浮点环境功能,仅若设置了 #pragma STDC FENV_ACCESS ON 才保证舍入。

示例

#include <stdio.h>
#include <stdlib.h>
#include <fenv.h>
#include <math.h>
int main()
{
#pragma STDC FENV_ACCESS ON
    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

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.6/8 Floating-point environment <fenv.h> (p: 207)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.6/7 Floating-point environment <fenv.h> (p: 188)

参阅

获得或设置数字的舍入方向
(函数)