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

# bcpow

(PHP 4, PHP 5, PHP 7)

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

### 説明

bcpow ( string `$left_operand` , string `$right_operand` [, int `$scale` = 0 ] ) : string

`left_operand` の `right_operand` 乗を求めます。

### パラメータ

`left_operand`

  左オペランドを表す文字列。

`right_operand`

  右オペランドを表す文字列。

`scale`

  このオプションパラメータを使用して、 結果の小数点以下の桁数を指定します。省略した場合は、bcscale() 関数でグローバルに設定した桁数をデフォルトとして使用します。それも設定されていない場合は 0 を使用します。

### 返り値

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

### 例

例1 bcpow() の例

`<?php
echo bcpow('4.2', '3', 2); // 74.08
?>`

### 注意

> 注意:

> bcpow() の返す結果の小数点以下の桁数は、 `scale` パラメータで指定したものより少なくなる可能性があります。 結果を表すのに `scale` で指定した桁数が不要な場合にのみそうなります。たとえば次のような場合です。

> 例2 bcpow() での桁数の例

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

### 参考

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