fegetround, fesetround

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境

复数算术

伪随机数生成

泛型数学

 

浮点环境

函数

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(void);	(2)	(C99 起)

1) 试图建立等于参数 round 的浮点舍入方向，期待参数为浮点舍入宏之一。

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

参数

round

-

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

返回值

1) 成功时为 ​0​ ，否则为非零。

2) 描述当前舍入方向的浮点舍入宏，或若不能确定方向则为负值

注意

当前舍入方向反映最近的 fesetround 的效果，亦能以 FLT_ROUNDS 查询。

示例

运行此代码

#include <stdio.h>
#include <math.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
void show_fe_current_rounding_method(void)
{
    printf("current rounding method:  ");
    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)
{
    /* 默认舍入方法 */
    show_fe_current_rounding_method();
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* 两整数的中央值 */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* 两整数的中央值 */
 
    /* 保存舍入方法。 */
    int curr_method = fegetround();
 
    /* 临时更改当前舍入方法。 */
    fesetround(FE_DOWNWARD);
    show_fe_current_rounding_method();
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));
 
    /* 恢复舍入方法。 */
    fesetround(curr_method);
    show_fe_current_rounding_method(); 
 
    return 0;
}

可能的输出：

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

引用

• C11 standard (ISO/IEC 9899:2011):

• 7.6.3.1 The fegetround function (p: 212)

• 7.6.3.2 The fesetround function (p: 212-213)

• C99 standard (ISO/IEC 9899:1999):

• 7.6.3.1 The fegetround function (p: 193)

• 7.6.3.2 The fesetround function (p: 193-194)

参阅

nearbyintnearbyintfnearbyintl (C99)(C99)(C99)	用当前舍入模式取整到整数 (函数)
rintrintfrintllrintlrintflrintlllrintllrintfllrintl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	使用当前舍入模式取整到整数，若结果有误则产生异常 (函数)