feholdexcept

来自cppreference.com
< c‎ | numeric‎ | fenv
定义于头文件 <fenv.h>
int feholdexcept( fenv_t* envp );
(C99起)

首先,它将当前浮点环境存储于envp所指向的对象中(同fegetenv),然后清除所有浮点状态标志,再安装不停止模式:未来的浮点数异常将不会中断执行(不会令其陷入),直到浮点环境为feupdateenvfesetenv所恢复。

此函数可用于开始必须对调用方隐藏它所引发的浮点异常的子程序。若只有部分异常需要被压制,同时另一些要被汇报,则不停止模式通常会清理不想要的异常后以调用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);
 
    /* Raise inexact and overflow exceptions. */
    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)

[编辑] 参阅

恢复浮点环境并引发之前引发过的异常
(函数) [edit]
保存或恢复当前浮点环境
(函数) [edit]
默认浮点环境
(宏常量) [edit]
feholdexceptC++文档