PHPのbcadd()関数を使って2つの任意精度数値を加算する方法

PHPでは、bcadd()という数学関数を使用することで、2つの任意精度（多倍長精度）の数値を正確に加算できます。bcadd()関数は、任意精度の2つの数値を文字列として受け取り、指定された桁数（スケール）に結果を揃えたうえで、その合計値を返します。

通常の浮動小数点演算では発生しうる誤差を回避できるため、金額計算など高い精度が求められる場面で特に役立ちます。この関数を使用するには、PHPにBCMath拡張モジュールがインストールされている必要があります。

構文

string bcadd ( $num_str1, $num_str2, $scaleVal)

パラメータ

bcadd()関数は、$num_str1、$num_str2、$scaleVal の3つの引数を受け取ります。

• $num_str1 - 左オペランド（被加算数）を表します。文字列型のパラメータです。

• $num_str2 - 右オペランド（加算数）を表します。こちらも文字列型のパラメータです。

• $scaleVal - 省略可能なパラメータです。結果の出力において、小数点以下の桁数を指定するために使用します。デフォルト値は0です。

戻り値

bcadd()関数は、2つのオペランド$num_str1と$num_str2の合計を、文字列型として返します。

例1：$scaleValパラメータを使用しないbcadd()関数

<?php
   // bcadd()関数の使用例
   // 任意精度の2つの入力数値
   $num_string1 = "5";
   $num_string2 = "10.555";

    // $scaleValを指定せずに
    // 2つの数値の加算を計算
   $result = bcadd($num_string1, $num_string2);
   echo "scaleValなしの出力結果: ", $result;
?>

出力

scaleValなしの出力結果: 15

解説：上記のPHPサンプルでは、$num_string1と$num_string2の2つのパラメータのみを使ってbcadd()関数で加算を行っています。$scaleValパラメータは指定されていないため、小数点以下の桁数はデフォルトの0となり、出力結果は「15」となり、小数部分は切り捨てられます。

例2：$scaleValパラメータを使用するbcadd()関数

次に、同じ入力値に対して$scaleValパラメータを追加し、出力がどのように変化するか確認してみましょう。

<?php
   // bcadd()関数の使用例
   // 任意精度の2つの入力数値
   $num_string1 = "5";
   $num_string2 = "10.555";

    // スケール値として2を指定
   $scaleVal = 2;

    // $scaleValパラメータを指定して
    // 2つの数値の加算を計算
   $result = bcadd($num_string1, $num_string2, $scaleVal);
   echo "scaleValありの出力結果: ", $result;
?>

出力

scaleValありの出力結果: 15.55

解説：この例では$scaleValに「2」を指定しているため、小数点以下2桁までの精度で結果が出力され、「15.55」が返されています。このように$scaleValを活用することで、必要な精度に応じた柔軟な加算処理が可能になります。