fegetenv, fesetenv

 

C

言語

ヘッダ

型サポート

プログラムユーティリティ

可変長引数サポート

エラー処理

動的メモリ管理

日付と時間のユーティリティ

文字列ライブラリ

アルゴリズム

数値演算

入出力サポート

ローカライゼーションサポート

アトミック操作 (C11)

スレッドサポート (C11)

技術仕様書

 

数値演算

一般的な数学関数

浮動小数点環境 (C99)

複素数算術 (C99)

乱数生成

型総称数学 (C99)

 

浮動小数点環境

関数

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)

 

<tbody> </tbody>

ヘッダ <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、そうでなければ非ゼロ。

例

Run this code

#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 standard (ISO/IEC 9899:2011):

• 7.6.4.1 The fegetenv function (p: 213)

• 7.6.4.3 The fesetenv function (p: 214)

• C99 standard (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