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

C++のlog1p()関数の概要

C++のlog1p()関数は、任意の数値 a に対して「(a + 1) の自然対数（底が e の対数）」を計算するための関数です。戻り値として (a+1) の自然対数の値が返されます。

なお、引数に -1 未満の値 を渡した場合は、有効な結果が得られないため NaN（Not a Number） が返される点に注意が必要です。

数学的な表現

log1p() の動作は、次の数式で表すことができます。

log1p(a) = base-e log(a+1)

log1p()の構文

C++における log1p() 関数の構文は以下のとおりです。

float log1p(float variable_name);

パラメータ

• variable_name − 対数値を計算したい変数に付けられた任意の名前です。この変数の値に対して (値 + 1) の自然対数が求められます。

log1p()の使用例

ここで、C++言語における log1p() の具体的な使用例を見てみましょう。

サンプルコード

#include <iostream>
#include <cmath>
using namespace std;

int main() {
    int x = 10;
    float y = 28.88;

    cout << "The log value of x : " << log1p(x);
    cout << "\nThe log value of y : " << log1p(y);

    return 0;
}

実行結果

上記のコードを実行すると、次のような出力が得られます。

The log value of x : 2.3979
The log value of y : 3.39719

まとめ

log1p() 関数は、小さな値に対する対数計算の精度を高めたい場合などに役立つ便利な関数です。通常の log(a+1) の計算では、a が非常に小さい値のときに桁落ちによる誤差が発生しやすくなりますが、log1p() を使うことでその問題を回避できます。引数が -1 未満の場合は NaN が返されるため、入力値の範囲には十分注意して使用しましょう。