fegetenv、fesetenv

 

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 fegetenv( fenv_t* envp );	(1)	(C99以降)
int fesetenv( const fenv_t* envp );	(2)	(C99以降)

1) envp が指すオブジェクトに浮動小数点環境の状態を格納しようとします。

2) envp が指すオブジェクトから浮動小数点環境を確立しようとします。そのオブジェクトの値は、以前に feholdexcept または fegetenv の呼び出しによって取得されたものであるか、浮動小数点マクロ定数である必要があります。envp で浮動小数点ステータスフラグのいずれかが設定されている場合、それらは環境で設定され（その後 fetestexcept でテスト可能になります）、対応する浮動小数点例外は発生しません（実行は中断されずに継続します）。

[編集] パラメータ

envp

-

浮動小数点環境の状態を保持する fenv_t 型のオブジェクトへのポインタ

[編集] 戻り値

成功した場合は ​0​、それ以外の場合はゼロ以外の値を返します。

[編集] 例

このコードを実行

#include <stdio.h>
#include <math.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");
    printf("\n");
}
 
void show_fe_rounding_method(void)
{
    printf("current rounding method:    ");
    switch (fegetround()) {
           case FE_TONEAREST:  printf ("FE_TONEAREST");  break;
           case FE_DOWNWARD:   printf ("FE_DOWNWARD");   break;
           case FE_UPWARD:     printf ("FE_UPWARD");     break;
           case FE_TOWARDZERO: printf ("FE_TOWARDZERO"); break;
           default:            printf ("unknown");
    };
    printf("\n");
}
 
void show_fe_environment(void)
{
    show_fe_exceptions();
    show_fe_rounding_method();
}    
 
int main(void)
{
    fenv_t curr_env;
    int rtn;
 
    /* Show default environment. */
    show_fe_environment();
    printf("\n");
 
    /* Perform some computation under default environment. */
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* midway between two integers */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* midway between two integers */
    show_fe_environment();
    printf("\n");
 
    /* Save current environment. */
    rtn = fegetenv(&curr_env);
 
    /* Perform some computation with new rounding method. */
    feclearexcept(FE_ALL_EXCEPT);
    fesetround(FE_DOWNWARD);
    printf("1.0/0.0 = %f\n", 1.0/0.0);
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));
    show_fe_environment();
    printf("\n");
 
    /* Restore previous environment. */
    rtn = fesetenv(&curr_env);
    show_fe_environment();
 
    return 0;
}

出力

current exceptions raised: none
current rounding method:   FE_TONEAREST
 
+11.5 -> +12.0
+12.5 -> +12.0
current exceptions raised: FE_INEXACT
current rounding method:   FE_TONEAREST
 
1.0/0.0 = inf
+11.5 -> +11.0
+12.5 -> +12.0
current exceptions raised: FE_DIVBYZERO FE_INEXACT
current rounding method:   FE_DOWNWARD
 
current exceptions raised: FE_INEXACT
current rounding method:   FE_TONEAREST

[編集] 参照

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

• 7.6.4.1 The fegetenv function (p: 213)

• 7.6.4.3 The fesetenv function (p: 214)

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

• 7.6.4.1 The fegetenv function (p: 194)

• 7.6.4.3 The fesetenv function (p: 195)

[編集] 関連項目

feholdexcept (C99)	環境を保存し、すべてのステータスフラグをクリアし、以降のすべてのエラーを無視する (関数)
feupdateenv (C99)	浮動小数点環境を復元し、以前に発生した例外を発生させる (関数)
FE_DFL_ENV (C99)	デフォルトの浮動小数点環境 (マクロ定数)
C++ ドキュメント （fegetenv、fesetenv）