feholdexcept

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

數值

常用數學函式

浮點環境 (C99)

偽隨機數生成

複數運算 (C99)

型別通用數學 (C99)

位操作 (C23)

檢查整數運算 (C23)

 

浮點環境

函式

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)   /* times two */
{
    fenv_t curr_excepts;
 
    /* Save and clear current f-p environment. */
    feholdexcept(&curr_excepts);
 
    /* Raise inexact and overflow exceptions. */
    printf("In x2():  x = %f\n", x=x*2.0);
    show_fe_exceptions();
    feclearexcept(FE_INEXACT);   /* hide inexact exception from caller */
 
    /* Merge caller's exceptions (FE_INVALID)        */
    /* with remaining x2's exceptions (FE_OVERFLOW). */
    feupdateenv(&curr_excepts);
    return x;
}
 
int main(void)
{    
    feclearexcept(FE_ALL_EXCEPT);
    feraiseexcept(FE_INVALID);   /* some computation with invalid argument */
    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 標準 (ISO/IEC 9899:2011)

• 7.6.4.2 feholdexcept 函式 (p: 213-214)

• C99 標準 (ISO/IEC 9899:1999)

• 7.6.4.2 feholdexcept 函式 (p: 194-195)

參閱

feupdateenv (C99)	恢復浮點環境並引發先前引發的異常 (函式)
fegetenvfesetenv (C99)	儲存或恢復當前浮點環境 (函式)
FE_DFL_ENV (C99)	預設浮點環境 (宏常量)
feholdexcept 的 C++ 文件