feraiseexcept

 

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 feraiseexcept( int excepts );		(C99以降)

excepts（浮動小数点例外マクロのビットごとのOR）で指定されたすべての浮動小数点例外を発生させようとします。指定された例外のいずれかがFE_OVERFLOWまたはFE_UNDERFLOWである場合、この関数は追加でFE_INEXACTを発生させる場合があります。例外の発生順序は未指定ですが、FE_OVERFLOWおよびFE_UNDERFLOWは常にFE_INEXACTの前に発生します。

[編集] パラメータ

excepts

-

発生させる例外フラグを示すビットマスク

[編集] 戻り値

指定されたすべての例外が発生した場合は​0​、それ以外の場合はゼロ以外の値。

[編集] 例

このコードを実行

#include <stdio.h>
#include <fenv.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");
    feclearexcept(FE_ALL_EXCEPT);
    printf("\n");
}
 
double some_computation(void)
{
    /* Computation reaches a state that causes overflow. */
    int r = feraiseexcept(FE_OVERFLOW | FE_INEXACT);
    printf("feraiseexcept() %s\n", (r?"fails":"succeeds"));
    return 0.0;
}
 
int main(void)
{
    some_computation();
    show_fe_exceptions();
 
    return 0;
}

出力

feraiseexcept() succeeds
current exceptions raised:  FE_INEXACT FE_OVERFLOW

[編集] 参考文献

• C11標準 (ISO/IEC 9899:2011)

• 7.6.2.3 The feraiseexcept function (p: 210)

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

• 7.6.2.3 The feraiseexcept function (p: 191)

[編集] 関連項目

feclearexcept (C99)	指定された浮動小数点ステータスフラグをクリアする (関数)
fetestexcept (C99)	指定された浮動小数点ステータスフラグのうちどれが設定されているかを判定する (関数)
feraiseexcept の C++ ドキュメント