fegetround, fesetround

 

C

编译器支持

语言

头文件

类型支持

程序工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数算术 (C99)

类型泛型数学 (C99)

 

浮点环境

函数

feclearexcept (C99)

fetestexcept (C99)

feraiseexcept (C99)

fegetexceptflagfesetexceptflag (C99)(C99)

fegetroundfesetround (C99)(C99)

fegetenvfesetenv (C99)

feholdexcept (C99)

feupdateenv (C99)

宏常量

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C99)

FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C99)

FE_DFL_ENV (C99)

 

在头文件 <fenv.h> 中定义
int fesetround( int round );	(1)	(C99 起)
int fegetround();	(2)	(C99 起)

1) 尝试将浮点舍入方向设置为等于参数 round，该参数应为 浮点舍入宏 之一。

2) 返回与当前舍入方向对应的 浮点舍入宏 的值。

参数

round

-

舍入方向，浮点舍入宏 之一

返回值

1) 成功时返回 ​0​，否则返回非零值。

2) 描述当前舍入方向的 浮点舍入宏，如果无法确定方向，则返回负值。

注意

当前舍入模式反映了最近一次 fesetround 的影响，也可以使用 FLT_ROUNDS 查询。

示例

运行此代码

#include <fenv.h>
#include <math.h>
#include <stdio.h>
 
// #pragma STDC FENV_ACCESS ON
 
void show_fe_current_rounding_direction(void)
{
    printf("current rounding direction:  ");
    switch (fegetround())
    {
           case FE_TONEAREST:  printf ("FE_TONEAREST");  break;
           case FE_DOWNWARD:   printf ("FE_DOWNWARD");   break;
           case FE_UPWARD:     printf ("FE_UPWARD");     break;
           case FE_TOWARDZERO: printf ("FE_TOWARDZERO"); break;
           default:            printf ("unknown");
    };
    printf("\n");
}
 
int main(void)
{
    /* Default rounding direction */
    show_fe_current_rounding_direction();
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* midway between two integers */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* midway between two integers */
 
    /* Save current rounding direction. */
    int curr_direction = fegetround();
 
    /* Temporarily change current rounding direction. */
    fesetround(FE_DOWNWARD);
    show_fe_current_rounding_direction();
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));
 
    /* Restore default rounding direction. */
    fesetround(curr_direction);
    show_fe_current_rounding_direction();
 
    return 0;
}

可能输出

current rounding direction:  FE_TONEAREST
+11.5 -> +12.0
+12.5 -> +12.0
current rounding direction:  FE_DOWNWARD
+11.5 -> +11.0
+12.5 -> +12.0
current rounding direction:  FE_TONEAREST

参考

• C23 标准 (ISO/IEC 9899:2024)

• 7.6.3.1 fegetround 函数 (p: TBD)

• 7.6.3.2 fesetround 函数 (p: TBD)

• C17 标准 (ISO/IEC 9899:2018)

• 7.6.3.1 fegetround 函数 (p: TBD)

• 7.6.3.2 fesetround 函数 (p: TBD)

• C11 标准 (ISO/IEC 9899:2011)

• 7.6.3.1 fegetround 函数 (p: 212)

• 7.6.3.2 fesetround 函数 (p: 212-213)

• C99 标准 (ISO/IEC 9899:1999)

• 7.6.3.1 fegetround 函数 (p: 193)

• 7.6.3.2 fesetround 函数 (p: 193-194)

另见

nearbyintnearbyintfnearbyintl (C99)(C99)(C99)	使用当前舍入模式舍入到整数 (函数)
rintrintfrintllrintlrintflrintlllrintllrintfllrintl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	使用当前舍入模式舍入到整数，如果结果不同，则抛出异常 异常 (函数)
C++ 文档 关于 fegetround, fesetround