std::nearbyint, std::nearbyintf, std::nearbyintl
提供: cppreference.com
| ヘッダ <cmath> で定義
|
||
| float nearbyint ( float arg ); float nearbyintf( float arg ); |
(1) | (C++11以上) |
| double nearbyint ( double arg ); |
(2) | (C++11以上) |
| long double nearbyint ( long double arg ); long double nearbyintl( long double arg ); |
(3) | (C++11以上) |
| double nearbyint ( 整数型 arg ); |
(4) | (C++11以上) |
目次 |
[編集] 引数
| arg | - | 浮動小数点値 |
[編集] 戻り値
現在の丸めモードに従った、 arg に最も近い整数が返されます。
[編集] エラー処理
この関数は math_errhandling で規定されているいかなるエラーの対象でもありません。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- FE_INEXACT が発生することはありません。
-
argが ±∞ であれば、それが変更せずに返されます。 -
argが ±0 であれば、それが変更せずに返されます。 -
argが NaN であれば、 NaN が返されます。
[編集] ノート
std::nearbyint と std::rint の唯一の違いは、 std::nearbyint が FE_INEXACT を発生させないことです。
すべての標準の浮動小数点フォーマットにおいて、最も大きな表現可能な浮動小数点値は正確な整数であるため、 std::nearbyint それ自体はオーバーフローすることはありません。 しかし任意の整数型 (std::intmax_t も含みます) は、整数変数に格納するとき、結果がオーバーフローするかもしれません。
現在の丸めモードが FE_TONEAREST の場合、この関数は (rint と同様に、しかし round とは異なり)、中間の場合、偶数に丸めます。
[編集] 例
Run this code
#include <iostream> #include <cmath> #include <cfenv> int main() { #pragma STDC FENV_ACCESS ON std::fesetround(FE_TONEAREST); std::cout << "rounding to nearest: \n" << "nearbyint(+2.3) = " << std::nearbyint(2.3) << " nearbyint(+2.5) = " << std::nearbyint(2.5) << " nearbyint(+3.5) = " << std::nearbyint(3.5) << '\n' << "nearbyint(-2.3) = " << std::nearbyint(-2.3) << " nearbyint(-2.5) = " << std::nearbyint(-2.5) << " nearbyint(-3.5) = " << std::nearbyint(-3.5) << '\n'; std::fesetround(FE_DOWNWARD); std::cout << "rounding down:\n" << "nearbyint(+2.3) = " << std::nearbyint(2.3) << " nearbyint(+2.5) = " << std::nearbyint(2.5) << " nearbyint(+3.5) = " << std::nearbyint(3.5) << '\n' << "nearbyint(-2.3) = " << std::nearbyint(-2.3) << " nearbyint(-2.5) = " << std::nearbyint(-2.5) << " nearbyint(-3.5) = " << std::nearbyint(-3.5) << '\n'; std::cout << "nearbyint(-0.0) = " << std::nearbyint(-0.0) << '\n' << "nearbyint(-Inf) = " << std::nearbyint(-INFINITY) << '\n'; }
出力:
rounding to nearest: nearbyint(+2.3) = 2 nearbyint(+2.5) = 2 nearbyint(+3.5) = 4 nearbyint(-2.3) = -2 nearbyint(-2.5) = -2 nearbyint(-3.5) = -4 rounding down: nearbyint(+2.3) = 2 nearbyint(+2.5) = 2 nearbyint(+3.5) = 3 nearbyint(-2.3) = -3 nearbyint(-2.5) = -3 nearbyint(-3.5) = -4 nearbyint(-0.0) = -0 nearbyint(-Inf) = -inf
[編集] 関連項目
| (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11) |
現在の丸めモードを使用して最も近い整数に丸めますが、結果が異なる場合は例外を発生します (関数) |
| (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11) |
最も近い整数を返します。 ちょうど中間の場合はゼロから離れる方向に丸めます (関数) |
| (C++11)(C++11) |
丸め方向を取得または設定します (関数) |
| nearbyint の C言語リファレンス
| |
