PHP マニュアル: 任意精度数値をべき乗する

説明

string bcpow(string $num, string $exponent, intnull $scale = null)

num の exponent 乗を求めます。

パラメータ

num: 基数を表す文字列。
exponent: 指数を表す文字列。指数が整数でない場合、値は切り捨てられます。正しい指数の範囲はプラットフォーム依存ですが、少なくとも -2147483648 から 2147483647 までの範囲を持ちます。
scale: このオプションパラメータを使用して、結果の小数点以下の桁数を指定します。省略した場合は、bcscale 関数でグローバルに設定した桁数をデフォルトとして使用します。それも設定されていない場合は 0 を使用します。

戻り値

結果を文字列で返します。

変更履歴

バージョン	説明
7.3.0	bcpow 関数は、指定されたスケールで値を返すようになりました。これより前のバージョンでは、後に続く0の桁が省略された数値が返される可能性がありました。

例

例1 bcpow の例


<?php

echo bcpow('4.2', '3', 2); // 74.08

?>

注意

注意:
PHP 7.3.0 より前のバージョンでは、 bcmul は scale 引数で指定したものより少ない桁数を返す可能性がありました。これは scale で許された精度が不要な場合にだけ起きていました。たとえば、以下のような場合です:

例2 bcpow で scale を指定する例

<?php echo bcpow('5', '2', 2); // 結果は "25.00" ではなく "25" となります ?>

参考

bcpowmod
bcsqrt