# 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` 所指向的对象建立浮点环境状态。对象的值必须是以先前调用 feholdexcept 或 `fegetenv` 获得值或是浮点宏常量。若 `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 标准（ISO/IEC 9899:2011）：

  - 7.6.4.1 The fegetenv function (p: 213)

  - 7.6.4.3 The fesetenv function (p: 214)

- C99 标准（ISO/IEC 9899:1999）：

  - 7.6.4.1 The fegetenv function (p: 194)

  - 7.6.4.3 The fesetenv function (p: 195)

### 参阅

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