C++のscalbn()関数とは？使い方とサンプルコードをわかりやすく解説

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

scalbn()関数とは？

scalbn() はC++ STLに標準で組み込まれた数学関数の一つで、<cmath> ヘッダーファイル内で定義されています。この関数は、仮数（significand）を浮動小数点基数のべき乗を使って効率的にスケーリング（拡大・縮小）するために使用されます。

ここでいう仮数とは、浮動小数点数を構成する有効数字の部分を指します。指数の解釈によって、仮数は整数としても小数としても表現できます。

scalbn() 関数は、「num × FLT_RADIXⁿ」という計算を行います。FLT_RADIXはすべての浮動小数点データ型における基数（多くの環境では2）であり、numは仮数の値、nは指数値です。なお、同様の機能を持つ関数として、第2引数がlong型である scalbln() や、内部的に同じ演算を行う ldexp() などもあります。

構文

double scalbn( double num, int n );
float scalbn( float num, int n );
long double scalbn( long double num, int n );

引数の型に応じて、上記のようにオーバーロードされた複数のバージョンが用意されています。

パラメータ

この関数は、次の引数を受け取ります。

• num − スケーリング対象となる仮数の値です。
• n − 基数を掛ける回数を示す指数の値です（int型）。

戻り値

計算が成功した場合、num × FLT_RADIXⁿ の結果を返します。エラーが発生した場合には、math_errhandling に従ってエラー処理が行われます。

使用例

基本的な呼び出し

入力

scalbn(5, 7);

出力

640

これは「5 × 2⁷ = 640」という計算に相当します。

サンプルコード1：int型の値を使用する場合

#include <bits/stdc++.h>
using namespace std;
int main(){
    int a = 7;
    int b = 5;
    int hold;
    hold = scalbn(b, a);
    cout << "Equation is: " << b << " * " << FLT_RADIX << "^" << a << " = " << hold << endl;
    return 0;
}

出力

Equation is: 5 * 2^7 = 640

サンプルコード2：float型の値を使用する場合

#include <bits/stdc++.h>
using namespace std;
int main(){
    float a = 2.3;
    float b = 7.8;
    float hold;
    hold = scalbn(b, a);
    cout << "Equation is: " << b << " * " << FLT_RADIX << "^" << a << " = " << hold << endl;
    return 0;
}

出力

Equation is: 7.8 * 2^2 = 31.2

なお、第2引数の指数はint型として定義されているため、float型の 2.3 を渡すと小数部分が切り捨てられ、2 として扱われます。そのため、計算結果は「7.8 × 2² = 7.8 × 4 = 31.2」となります。

まとめ

scalbn() 関数は、仮数と基数のべき乗を掛け合わせるシンプルながら有用な関数です。特に、2のべき乗による高速な乗除算が必要な場面や、浮動小数点数の正規化処理などで活躍します。引数の型（特に指数がint型である点）に注意しながら活用しましょう。