C++のnearbyint()関数とは？使い方と実行例をわかりやすく解説

本記事では、C++ STLに用意されているnearbyint()関数の仕組み、構文、そして具体的な使用例について詳しく解説します。

nearbyint()関数とは？

nearbyint()は、C++標準ライブラリ（STL）に組み込まれている数学関数の一つで、<cmath>ヘッダーファイルで定義されています。この関数は、引数として渡された値を、現在設定されている丸めモードに従って最も近い整数値へと丸めた結果を返します。

丸めの方式はfegetround()で取得できる現在の丸めモードによって決まります。デフォルトでは「偶数への丸め（銀行家の丸め）」が適用されるため、たとえば2.5は2に、3.5は4に丸められるという特徴があります。

なお、この関数はfloat型、double型、long double型のいずれの値も引数として受け取ることができます。

構文

double nearbyint(double num);
float nearbyint(float num);
long double nearbyint(long double num);

パラメータ

この関数は以下のパラメータを受け取ります。

• num − 丸め対象となる数値。

戻り値

引数numを丸めた結果の整数値を返します。

使用例

入力例1

nearbyint(2.13);

出力

2

入力例2

nearbyint(3.4);

出力

3

サンプルコード①：小数点以下が切り捨てられるケース

#include <bits/stdc++.h>
using namespace std;
int main(){
    float var = 3.4;
    cout<<"value of var is: " <<var<< endl;
    cout<<"value after round off is: "<<nearbyint(var);
    return 0;
}

出力

value of var is: 3.4
value after round off is: 3

この例では、変数varに3.4を代入し、nearbyint()で丸めています。3.4は最も近い整数である3に丸められます。

サンプルコード②：小数点以下が切り上げられるケース

#include <bits/stdc++.h>
using namespace std;
int main(){
    float var = 7.9;
    cout<<"value of var is: " <<var<< endl;
    cout<<"value after round off is: "<<nearbyint(var);
    return 0;
}

出力

value of var is: 7.9
value after round off is: 8

こちらの例では7.9を丸めており、最も近い整数である8が出力されます。このように、nearbyint()は小数部分の値に応じて自動的に切り上げ・切り捨てを行います。

まとめ

nearbyint()関数は、現在の丸めモードに従って浮動小数点数を最も近い整数に丸めるための便利な関数です。round()関数との違いは、丸めモードの影響を受ける点にあります。数値計算において正確な丸め処理が必要な場面で活用してみてください。