C/C++のldexp()関数とは？使い方とエラー処理を実例付きで解説

ldexp()関数の基本

本記事では、C/C++で利用できるldexp()関数の役割と具体的な使い方について解説します。ldexp()関数は、指定した値 x に「2のexp乗」を掛けた結果（x × 2^exp）を返す数学関数です。引数としては、浮動小数点数の x と整数型の指数 exp の2つを受け取ります。

構文

ldexp()関数の構文は以下の通りです。引数の型に応じて複数のオーバーロードが用意されています。

float ldexp(float x, int exp)
double ldexp(double x, int exp)
long double ldexp(long double x, int exp)
double ldexp(T x, int exp)

基本的な使用例

それでは、実際のコード例を見てみましょう。以下のプログラムでは、10 × 2² を計算しています。

#include <iostream>
#include <cmath>
using namespace std;
int main() {
    double a = 10, res;
    int exp = 2;
    res = ldexp(a, exp); // a × (2^exp) を計算
    cout << "The result is = " << res << endl;
}

実行結果

The result is = 40

この例では、10 × 2² = 40 が正しく出力されていることが分かります。

エラー処理：結果が大きすぎる場合

続いて、この関数で発生しうるエラーについて確認しましょう。計算結果が浮動小数点型で表現可能な範囲を超える場合、ldexp()関数は HUGE_VAL を返します。HUGE_VAL は無限大（inf）として出力されます。

以下に、意図的にオーバーフローを発生させる例を示します。

#include <iostream>
#include <cmath>
using namespace std;
int main() {
    double a = 10, res;
    int exp = 5000;
    res = ldexp(a, exp); // a × (2^exp) を計算
    cout << "The result is = " << res << endl;
}

実行結果

The result is = inf

指数として5000を指定したため、結果が double 型で表現できる範囲を超え、戻り値が inf（HUGE_VAL）になっています。このように、ldexp()を使用する際は、指数の大きさによって結果がオーバーフローする可能性があることに注意が必要です。必要に応じて戻り値のチェックを行い、適切なエラー処理を実装することをおすすめします。