当前位置： C语言 -- 标准库 -- <fenv.h> -- feupdateenv

feupdateenv函数

概要： 
#include <fenv.h>
int feupdateenv(const fenv_t *envp);
描述：

该函数尝试将当前浮点异常保存在其自动存储区，安装参数envp指向对象表示的浮点环境，然后引发保存的浮点异常。调用feupdateenv函数后，浮点异常包括调用feupdateenv函数前浮点环境的浮点异常和参数envp指向对象表示的浮点环境的浮点异常。参数envp指向对象应通过调用fegetenv或者feholdexcept函数获取，或者等于浮点环境宏，例如：FE_DFL_ENV。

函数fegetenv、feholdexcept、fesetenv、feupdateenv将浮点环境（状态标志和控制模式）作为一个整体操作。

参数：
const fenv_t *envp

参数为一个指向fenv_t类型对象的指针。

返回值：

如果所有操作都成功执行，函数返回0；否则函数返回一个非0值。

范例： 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
/*函数feupdateenv范例*/

#include <fenv.h>
#include <math.h>
#include <stdio.h>

#pragma STDC FENV_ACCESS ON

void showExceptions(void)
{
    printf("Exceptions: ");
    /*判断是否设置浮点异常。*/
    if(fetestexcept(FE_ALL_EXCEPT)==0)
    {
        puts("No floating-point status flag is set.");
    }
    else
    {
    	/*判断设置的浮点异常。*/
        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 ");
        puts("");
    }
}

void showRoundingDirection(void)
{
    printf("Rounding direction: ");
    switch(fegetround())
    {
    case FE_DOWNWARD:
        puts("FE_DOWNWARD");
        break;
    case FE_TOWARDZERO:
        puts("FE_TOWARDZERO");
        break;
    case FE_UPWARD:
        puts("FE_UPWARD");
        break;
    default:
        puts("FE_TONEAREST");
        break;
    }
}

void showFloatingPointEnvironment(void)
{
    showExceptions();
    showRoundingDirection();
    puts("");
}

int main(void)
{
    double x;
    fenv_t currentEnv;

    /*第一阶段的浮点环境。*/
    x = exp(1000.0);
    printf("Stage 1 floating-point environment\n");
    showFloatingPointEnvironment();
    feholdexcept(&currentEnv);

    /*第二阶段的浮点环境。*/
    fesetround(FE_UPWARD);
    x = exp(-1000.0);
    printf("Stage 2 floating-point environment\n");
    showFloatingPointEnvironment();

    /*第三阶段的浮点环境。*/
    feupdateenv(&currentEnv);
    printf("Stage 3 floating-point environment\n");
    showFloatingPointEnvironment();

    return 0;
}
输出：

Stage 1 floating-point environment

Exceptions: FE_INEXACT FE_OVERFLOW

Rounding direction: FE_TONEAREST

 

Stage 2 floating-point environment

Exceptions: FE_INEXACT FE_UNDERFLOW

Rounding direction: FE_UPWARD

 

Stage 3 floating-point environment

Exceptions: FE_INEXACT FE_OVERFLOW FE_UNDERFLOW

Rounding direction: FE_TONEAREST

注：使用GCC编译。

相关内容：
fegetenv 获取浮点环境的函数。
feholdexcept 保存当前浮点环境的函数。
fesetenv 设置浮点环境的函数。