FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

 

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> で定義
#define FE_DOWNWARD     /*実装定義*/		(C99以降)
#define FE_TONEAREST    /*実装定義*/		(C99以降)
#define FE_TOWARDZERO   /*実装定義*/		(C99以降)
#define FE_UPWARD       /*実装定義*/		(C99以降)

これらのマクロ定数はそれぞれ非負の整数定数式に展開され、サポートされている浮動小数点丸めモードのいずれかを示すためにfesetroundおよびfegetroundで使用できます。実装は、<fenv.h> で追加の丸めモード定数を定義する場合があります。これらの定数はすべてFE_で始まり、その後に少なくとも1つの大文字が続く必要があります。各マクロは、サポートされている場合にのみ定義されます。

Constant	説明
FE_DOWNWARD	負の無限大方向への丸め
FE_TONEAREST	最も近い表現可能な値への丸め
FE_TOWARDZERO	ゼロ方向への丸め
FE_UPWARD	正の無限大方向への丸め

実装によって追加の丸めモードがサポートされる場合があります。

現在の丸めモードは、以下に影響します。

• 定数式外の浮動小数点演算子の結果

double x = 1;
x / 10; // 0.09999999999999999167332731531132594682276248931884765625 or
        // 0.1000000000000000055511151231257827021181583404541015625

• 標準ライブラリの数学関数の結果

sqrt(2); // 1.41421356237309492343001693370752036571502685546875 or
         // 1.4142135623730951454746218587388284504413604736328125

• 浮動小数点から浮動小数点への暗黙の変換とキャスト

double d = 1 + DBL_EPSILON;
float f = d; // 1.00000000000000000000000 or
             // 1.00000011920928955078125

• strtodやprintfのような文字列変換

strtof("0.1", NULL); // 0.0999999940395355224609375 or
                     // 0.100000001490116119384765625

• nearbyint、rint、lrintのライブラリ丸め関数

lrint(2.1); // 2 or 3

現在の丸めモードは、以下には影響しません。

• 浮動小数点から整数への暗黙の変換とキャスト（常にゼロ方向）
• コンパイル時に実行される定数式内の浮動小数点演算子の結果（常に最近値方向）
• round、lround、llround、ceil、floor、truncのライブラリ関数

他の浮動小数点環境の機能と同様に、丸めが保証されるのは、#pragma STDC FENV_ACCESS ONが設定されている場合のみです。

プラ​​グマをサポートしないコンパイラは、現在の丸めモードをサポートするための独自の手段を提供する場合があります。たとえば、ClangとGCCには、丸め感度の高いコードの意味を変更する最適化を無効にするための-frounding-mathオプションがあります。

例

このコードを実行

#include <fenv.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
 
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    fesetround(FE_DOWNWARD);
    puts("rounding down: ");
    printf("           pi = %.22f\n", acosf(-1));
    printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL));
    printf("    rint(2.1) = %.22f\n\n", rintf(2.1));
    fesetround(FE_UPWARD);
    puts("rounding up: ");
    printf("           pi = %.22f\n", acosf(-1));
    printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL));
    printf("    rint(2.1) = %.22f\n", rintf(2.1));
}

出力

rounding down:
           pi = 3.1415925025939941406250
strtof("1.1") = 1.0999999046325683593750
    rint(2.1) = 2.0000000000000000000000
 
rounding up:
           pi = 3.1415927410125732421875
strtof("1.1") = 1.1000000238418579101563
    rint(2.1) = 3.0000000000000000000000

参考文献

• C23標準 (ISO/IEC 9899:2024)

• 7.6/8 浮動小数点環境 <fenv.h> (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.6/8 浮動小数点環境 <fenv.h> (p: 151)

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

• 7.6/8 浮動小数点環境 <fenv.h> (p: 207)

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

• 7.6/7 浮動小数点環境 <fenv.h> (p: 188)

関連項目

fegetroundfesetround (C99)(C99)	丸め方向を取得または設定する (関数)
C++ ドキュメント （浮動小数点丸めマクロについて）