BcMath\Number::powmod
(PHP 8 >= 8.4.0)
BcMath\Number::powmod — Raises an arbitrary precision number, reduced by a specified modulus
说明
public BcMath\Number::powmod(BcMath\Number|string|int
$exponent, BcMath\Number|string|int $modulus, ?int $scale = null): BcMath\Number
Use the fast-exponentiation method to raise $this to the power
exponent with respect to the modulus modulus.
参数
exponent- The exponent, as an non-negative and integral (i.e. the scale has to be zero).
modulus- The modulus, as an integral (i.e. the scale has to be zero).
scale-
BcMath\Number::scale explicitly specified for calculation results.
If
null, the BcMath\Number::scale of the calculation result will be set automatically.
返回值
Returns the result as a new BcMath\Number object.
When the BcMath\Number::scale of the result object is automatically set,
the BcMath\Number::scale of the result object will always be 0.
错误／异常
This method throws a ValueError in the following cases:
exponentormodulusis string and not a well-formed BCMath numeric string- $this,
exponentormodulushas a fractional part exponentis a negative valuescaleis outside the valid range
This method throws a DivisionByZeroError exception if modulus
is 0.
示例
示例 #1 BcMath\Number::powmod() example when scale is not specified
<?php
var_dump(
new BcMath\Number('8')->powmod(new BcMath\Number('3'), 5),
new BcMath\Number('-8')->powmod(new BcMath\Number('3'), 5),
new BcMath\Number('8')->powmod('2', -3),
new BcMath\Number('-8')->powmod(5, 7),
);
?>以上示例会输出：
object(BcMath\Number)#3 (2) {
["value"]=>
string(1) "2"
["scale"]=>
int(0)
}
object(BcMath\Number)#4 (2) {
["value"]=>
string(2) "-2"
["scale"]=>
int(0)
}
object(BcMath\Number)#2 (2) {
["value"]=>
string(1) "1"
["scale"]=>
int(0)
}
object(BcMath\Number)#5 (2) {
["value"]=>
string(2) "-1"
["scale"]=>
int(0)
}
示例 #2 BcMath\Number::powmod() example of explicitly specifying scale
<?php
var_dump(
new BcMath\Number('8')->powmod(new BcMath\Number('3'), 5, 1),
new BcMath\Number('-8')->powmod(new BcMath\Number('3'), 5, 2),
new BcMath\Number('8')->powmod('2', -3, 3),
new BcMath\Number('-8')->powmod(5, 7, 4),
);
?>以上示例会输出：
object(BcMath\Number)#3 (2) {
["value"]=>
string(3) "2.0"
["scale"]=>
int(1)
}
object(BcMath\Number)#4 (2) {
["value"]=>
string(5) "-2.00"
["scale"]=>
int(2)
}
object(BcMath\Number)#2 (2) {
["value"]=>
string(5) "1.000"
["scale"]=>
int(3)
}
object(BcMath\Number)#5 (2) {
["value"]=>
string(7) "-1.0000"
["scale"]=>
int(4)
}
参见
- bcpowmod() - Raise an arbitrary precision number to another, reduced by a specified modulus
- BcMath\Number::pow() - Raises an arbitrary precision number
- BcMath\Number::mod() - Gets the modulus of an arbitrary precision number
＋添加备注
用户贡献的备注
此页面尚无用户贡献的备注。