PHPのlog1p()関数とは？使い方とサンプルコードを徹底解説

PHPのlog1p()関数は、log(1 + 数値) を計算するための数学関数です。この関数の大きな特徴は、引数として渡す数値がゼロに近い場合でも、高精度で計算結果を返せる点にあります。通常の log(1+x) の計算では、x が極端に小さい値だと浮動小数点数の精度の関係で誤差が生じやすくなりますが、log1p() を使えばその問題を回避できます。

構文

log1p(val)

パラメータ

• val − 計算対象となる数値を指定します。

戻り値

log1p() 関数は、log(1 + 数値) の計算結果を返します。数値がゼロに非常に近い場合でも、精度を保ったまま計算されるのが特徴です。

使用例

まずは、log1p(1)、つまり log(2) を計算してみましょう。

<?php
    echo(log1p(1));
?>

出力結果

0.69314718055995

log(2) の値である約 0.693 が返されていることがわかります。

使用例：引数が0の場合

次に、引数に 0 を指定した場合の動作を確認します。

<?php
    echo(log1p(0));
?>

出力結果

0

log(1 + 0) = log(1) = 0 となるため、正しく 0 が返されます。

使用例：複数の値を計算する

続いて、複数の異なる値を引数に渡した例を見てみましょう。

<?php
    echo(log1p(10));
    echo(log1p(2.7));
?>

出力結果

2.39789527279841.3083328196502

log1p(10) は約 2.3978952727984、log1p(2.7) は約 1.3083328196502 という結果が返されます。なお、echo で連続して出力しているため、結果がつながって表示されています。見やすくしたい場合は、それぞれ改行や区切り文字を加えるとよいでしょう。

まとめ

log1p() 関数は、log(1 + x) を高精度に計算したい場面で活躍する便利な関数です。特に金融計算など、微小な値を扱う処理において誤差を最小限に抑えられるため、通常の log() 関数で「1 + 極小の値」を計算する代わりに、積極的に活用することをおすすめします。