nearbyint, nearbyintf, nearbyintl

パラメータ

戻り値

arg に最も近い整数値を、 現在の丸めモード に従って返します。

エラーハンドリング

この関数は、 math_errhandling で指定されているいかなるエラーにも影響されません。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

• FE_INEXACT は決して発生しません。
• arg が ±∞ の場合、変更されずに返されます。
• arg が ±0 の場合、変更されずに返されます。
• arg が NaN の場合、NaN が返されます。

注記

nearbyint と rint の唯一の違いは、 nearbyint が決して FE_INEXACT を発生させないことです。

標準的な浮動小数点形式において、表現可能な最大の浮動小数点値はすべて正確な整数であるため、 nearbyint 単体では決してオーバーフローを起こしません。しかし、結果を整数型（ intmax_t を含む）の変数に格納する場合、その結果は整数型の範囲をオーバーフローする可能性があります。

現在の丸めモードが FE_TONEAREST の場合、この関数は中間の場合に偶数へ丸めます（ rint と同様ですが、 round とは異なります）。

例

#include <fenv.h>
#include <math.h>
#include <stdio.h>
int main(void)
{
// #pragma STDC FENV_ACCESS ON
    fesetround(FE_TONEAREST);
    printf("rounding to nearest:\nnearbyint(+2.3) = %+.1f  ", nearbyint(2.3));
    printf("nearbyint(+2.5) = %+.1f  ", nearbyint(2.5));
    printf("nearbyint(+3.5) = %+.1f\n", nearbyint(3.5));
    printf("nearbyint(-2.3) = %+.1f  ", nearbyint(-2.3));
    printf("nearbyint(-2.5) = %+.1f  ", nearbyint(-2.5));
    printf("nearbyint(-3.5) = %+.1f\n", nearbyint(-3.5));
    fesetround(FE_DOWNWARD);
    printf("rounding down: \nnearbyint(+2.3) = %+.1f  ", nearbyint(2.3));
    printf("nearbyint(+2.5) = %+.1f  ", nearbyint(2.5));
    printf("nearbyint(+3.5) = %+.1f\n", nearbyint(3.5));
    printf("nearbyint(-2.3) = %+.1f  ", nearbyint(-2.3));
    printf("nearbyint(-2.5) = %+.1f  ", nearbyint(-2.5));
    printf("nearbyint(-3.5) = %+.1f\n", nearbyint(-3.5));
    printf("nearbyint(-0.0) = %+.1f\n", nearbyint(-0.0));
    printf("nearbyint(-Inf) = %+.1f\n", nearbyint(-INFINITY));
}

rounding to nearest:
nearbyint(+2.3) = +2.0  nearbyint(+2.5) = +2.0  nearbyint(+3.5) = +4.0
nearbyint(-2.3) = -2.0  nearbyint(-2.5) = -2.0  nearbyint(-3.5) = -4.0
rounding down:
nearbyint(+2.3) = +2.0  nearbyint(+2.5) = +2.0  nearbyint(+3.5) = +3.0
nearbyint(-2.3) = -3.0  nearbyint(-2.5) = -3.0  nearbyint(-3.5) = -4.0
nearbyint(-0.0) = -0.0
nearbyint(-Inf) = -inf

参考文献

関連項目