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 The feholdexcept function (p: 213-214)

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

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

関連項目

feupdateenv (C99)	浮動小数点環境を復元し、以前に発生した例外を発生させる (関数)
fegetenvfesetenv (C99)	現在の浮動小数点環境を保存または復元する (関数)
FE_DFL_ENV (C99)	デフォルトの浮動小数点環境 (マクロ定数)
C++ ドキュメント for feholdexcept