Namespaces
Variants

fegetenv, fesetenv

From cppreference.net
< c ‎ | numeric ‎ | fenv
C
Numerics
Floating-point environment
ヘッダーで定義 <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 ​ 成功時は0、それ以外の場合は非ゼロ。

例

このコードを実行 
#include <stdio.h>
#include <math.h>
#include <fenv.h>
#pragma STDC FENV_ACCESS ON
void show_fe_exceptions(void)
{
    printf("現在発生している例外: ");
    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("現在の丸めモード:    ");
    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_fe_environment();
    printf("\n");
    /* デフォルト環境下で何らかの計算を実行します。 */
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* 2つの整数の中間点 */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* 2つの整数の中間点 */
    show_fe_environment();
    printf("\n");
    /* 現在の環境を保存 */
    rtn = fegetenv(&curr_env);
    /* 新しい丸め方法で計算を実行します。 */
    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");
    /* 前の環境を復元します。 */
    rtn = fesetenv(&curr_env);
    show_fe_environment();
    return 0;
}

出力: 

現在の例外発生状況: なし
現在の丸めモード:   FE_TONEAREST
+11.5 -> +12.0
+12.5 -> +12.0
現在の例外発生状況: FE_INEXACT
現在の丸めモード:   FE_TONEAREST
1.0/0.0 = inf
+11.5 -> +11.0
+12.5 -> +12.0
現在の例外発生状況: FE_DIVBYZERO FE_INEXACT
現在の丸めモード:   FE_DOWNWARD
現在の例外発生状況: FE_INEXACT
現在の丸めモード:   FE_TONEAREST

参考文献

  • C11標準 (ISO/IEC 9899:2011):
  • 7.6.4.1 fegetenv関数 (p: 213)
  • 7.6.4.3 fesetenv関数 (p: 214)
  • C99標準 (ISO/IEC 9899:1999):
  • 7.6.4.1 fegetenv関数 (p: 194)
  • 7.6.4.3 fesetenv関数 (p: 195)

関連項目

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