feholdexcept

 

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 feholdexcept( fenv_t* envp );		(C99 起)

首先，保存当前浮点环境到 envp 所指向的对象（类似 fegetenv ），然后清除所有浮点状态标志，再安装不停止模式：未来的浮点异常将不中断执行（不会陷落），直至以 feupdateenv 或 fesetenv 还原浮点状态。

此函数可用于必须从调用方隐藏它可能引发的浮点异常的子程序的起始。若只是必须抑制某些异常而必须报告其他，则通常在清除不想要的异常后，通过调用 feupdateenv 结束不停止模式。

参数

envp

-

指向 fenv_t 类型对象的指针，将存储浮点环境于其中

返回值

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

示例

运行此代码

#include <stdio.h>
#include <fenv.h>
#include <float.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");
}
 
double x2 (double x)   /* 乘二 */
{
    fenv_t curr_excepts;
 
    /* 保存并清除当前浮点异常。 */
    feholdexcept(&curr_excepts);
 
    /* 引发不准确和上溢异常。 */
    printf("In x2():  x = %f\n", x=x*2.0);
    show_fe_exceptions();
    feclearexcept(FE_INEXACT);   /* 从调用方隐藏不准确异常 */
 
    /* 将调用方的异常（ FE_INVALID ）并入剩下的 x2 的异常（ FE_OVERFLOW）。 */
    feupdateenv(&curr_excepts);
    return x;
}
 
int main(void)
{    
    feclearexcept(FE_ALL_EXCEPT);
    feraiseexcept(FE_INVALID);   /* 一些有非法参数的计算 */
    show_fe_exceptions();
    printf("x2(DBL_MAX) = %f\n", x2(DBL_MAX));
    show_fe_exceptions();
 
    return 0;
}

输出：

current exceptions raised:  FE_INVALID
In x2():  x = inf
current exceptions raised:  FE_INEXACT FE_OVERFLOW
x2(DBL_MAX) = inf
current exceptions raised:  FE_INVALID FE_OVERFLOW

引用

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

• 7.6.4.2 The feholdexcept function (p: 213-214)

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

• 7.6.4.2 The feholdexcept function (p: 194-195)

参阅

feupdateenv (C99)	恢复之前保存的浮点环境，并引发之前已经引发过的异常，使其存在于当前内存环境中 (函数)
fegetenvfesetenv (C99)(C99)	保存或恢复当前浮点环境，包括异常的标志和数字的舍弃模式 (函数)
FE_DFL_ENV (C99)	默认浮点环境 (宏常量)