Php/docs/function.bcpow

提供:Dev Guides
< Php
移動先:案内検索

bcpow

(PHP 4, PHP 5, PHP 7)

bcpow任意精度数値をべき乗する


説明

bcpow ( string $num , string $exponent [, int|null $scale = null ] ) : string

numexponent 乗を求めます。


パラメータ

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


返り値

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


変更履歴

バージョン 説明
7.3.0 bcpow() 関数は、指定されたスケールで値を返すようになりました。

これより前のバージョンでは、後に続く0の桁が省略された数値が返される可能性がありました。


例1 bcpow() の例

<?phpecho bcpow('4.2', '3', 2); // 74.08?>

注意

注意:

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

例2 bcpow() で scale を指定する例

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

参考

  • bcpowmod() - 任意精度数値のべき乗の、指定した数値による剰余
  • bcsqrt() - 任意精度数値の平方根を取得する