PHPのbcpowmod()関数の使い方を徹底解説！剰余付きべき乗計算の基本と実例

PHPのbcpowmod()関数は、任意精度の基数（base）を指定した指数（exponent）でべき乗し、さらに指定した法（modulus）で割った余りを求めるための関数です。この関数は、任意精度の数値を文字列として受け取り、指定された精度（スケール）に従って結果を整形した上で、「基数の指数乗を法で割った余り」を返します。

巨大な数値のべき乗剰余計算は、暗号処理などの分野で頻繁に利用されるため、bcpowmod()は非常に実用的な関数といえます。

構文

String bcpowmod($base, $exponent, $modulus, $scale)

パラメータ

bcpowmod()関数は、$base、$exponent、$modulus、$scale の4つのパラメータを受け取ります。

• $base： べき乗の対象となる左オペランド（基数）です。文字列型のパラメータです。

• $exponent： 指数を表す右オペランドです。文字列型のパラメータです。

• $modulus： 法（剰余を取るための値）を表すオペランドです。文字列型のパラメータです。

• $scale： 結果の小数点以下の桁数を指定する整数型のパラメータです。つまり、「(base^exponent % mod)」の計算結果において、小数点以下を何桁表示するかを決めます。デフォルト値は0です。

戻り値

bcpowmod()関数は、計算結果を文字列として返します。ただし、法（$modulus）が0の場合や、指数が負の値の場合はFalseを返します。

使用例1：scaleを指定しない場合

<?php
   // 任意精度の入力数値
   $base = "5";
   $exponent = "7";
   $mod = "7";

   // base^exponent % mod を計算
   $result = bcpowmod($base, $exponent, $mod);
   echo "scaleなしの出力: ", $result;
?>

出力

scaleなしの出力: 5

この例では、5の7乗（78,125）を7で割った余りである「5」が出力されます。

使用例2：scaleを指定した場合

<?php
   // 任意精度の入力数値
   $base = "5";
   $exponent = "7";
   $mod = "7";

   // scale値を4に設定
   $scale = 4;

   // base^exponent % mod を計算
   $result = bcpowmod($base, $exponent, $mod, $scale);
   echo "scaleありの出力: ", $result;
?>

出力

scaleありの出力: 5.0000

scaleに4を指定したことで、結果が小数点以下4桁で表示されています。このように$scaleパラメータを使えば、出力の精度を自由に制御できます。

まとめ

bcpowmod()関数を使うことで、PHPで任意精度のべき乗剰余計算を簡単かつ正確に行うことができます。大きな数値を扱う場合でも、文字列として数値を渡すことで精度の劣化を防げる点が大きなメリットです。暗号化処理や数値計算が必要な場面で、ぜひ活用してみてください。