fegetenv, fesetenv

< c‎ | numeric‎ | fenv
定义于头文件 <fenv.h>
int fegetenv( fenv_t* envp );
(1) (C99 起)
int fesetenv( const fenv_t* envp );
(2) (C99 起)

1) 试图存储浮点环境的状态于 envp 所指向的对象。

2) 试图从 envp 所指向的对象建立浮点环境状态。对象的值必须是以先前调用 feholdexceptfegetenv 获得值或是浮点宏常量。若 envp 中设置了任何浮点状态标志,则环境中标志变为被设置(然后可用 fetestexcept 测试),但不引发对应的浮点异常(执行持续而不中断)。

参数

envp - 指向 fenv_t 类型对象的指针,该对象保有浮点环境的状态

返回值

成功时返回 0 ,否则返回非零。

示例

#include <stdio.h>
#include <math.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
 
void show_fe_exceptions(void)
{
    printf("current exceptions raised: ");
    if(fetestexcept(FE_DIVBYZERO))     printf(" FE_DIVBYZERO");
    if(fetestexcept(FE_INEXACT))       printf(" FE_INEXACT");
    if(fetestexcept(FE_INVALID))       printf(" FE_INVALID");
    if(fetestexcept(FE_OVERFLOW))      printf(" FE_OVERFLOW");
    if(fetestexcept(FE_UNDERFLOW))     printf(" FE_UNDERFLOW");
    if(fetestexcept(FE_ALL_EXCEPT)==0) printf(" none");
    printf("\n");
}
 
void show_fe_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");
}
 
void show_fe_environment(void)
{
    show_fe_exceptions();
    show_fe_rounding_method();
}    
 
int main(void)
{
    fenv_t curr_env;
    int rtn;
 
    /* 显示默认环境。 */
    show_fe_environment();
    printf("\n");
 
    /* 在默认环境下做一些计算。 */
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* 两整数的中央值 */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* 两整数的中央值 */
    show_fe_environment();
    printf("\n");
 
    /* 保存当前环境。 */
    rtn = fegetenv(&curr_env);
 
    /* 以新舍入方法进行一些计算。 */
    feclearexcept(FE_ALL_EXCEPT);
    fesetround(FE_DOWNWARD);
    printf("1.0/0.0 = %f\n", 1.0/0.0);
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));
    show_fe_environment();
    printf("\n");
 
    /* 恢复先前环境。 */
    rtn = fesetenv(&curr_env);
    show_fe_environment();
 
    return 0;
}

输出:

current exceptions raised: none
current rounding method:   FE_TONEAREST
 
+11.5 -> +12.0
+12.5 -> +12.0
current exceptions raised: FE_INEXACT
current rounding method:   FE_TONEAREST
 
1.0/0.0 = inf
+11.5 -> +11.0
+12.5 -> +12.0
current exceptions raised: FE_DIVBYZERO FE_INEXACT
current rounding method:   FE_DOWNWARD
 
current exceptions raised: FE_INEXACT
current rounding method:   FE_TONEAREST

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.6.4.1 The fegetenv function (p: 213)
  • 7.6.4.3 The fesetenv function (p: 214)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.6.4.1 The fegetenv function (p: 194)
  • 7.6.4.3 The fesetenv function (p: 195)

参阅

保存当前环境的异常状态标志,再清除所有异常状态标志,并忽略所有未来错误
(函数)
恢复之前保存的浮点环境,并引发之前已经引发过的异常,使其存在于当前内存环境中
(函数)
默认浮点环境
(宏常量)