大网数据广告活动
PHP 语言与运行手册

bcpowmod · Raise an arbitrary precision number to another, reduced by a specified modulus

· 52CE 我爱测

bcpowmod — Raise an arbitrary precision number to another, reduced by a specified modulus

bcpowmod

(PHP 5, PHP 7, PHP 8)

bcpowmod — Raise an arbitrary precision number to another, reduced by a specified modulus

说明

function bcpowmod(
    string $num,
    string $exponent,
    string $modulus,
    ?int $scale = null
): string

Use the fast-exponentiation method to raise num to the power exponent with respect to the modulus modulus.

参数

num

The base, as an integral string (i.e. the scale has to be zero).

exponent

The exponent, as an non-negative, integral string (i.e. the scale has to be zero).

modulus

The modulus, as an integral string (i.e. the scale has to be zero).

scale

此参数用于设置结果小数点后的位数。 如果为 null,则默认为使用 bcscale() 设置的默认精度, 或者回退到 bcmath.scale INI 指令的值。

返回值

Returns the result as a string.

错误/异常

This function throws a ValueError in the following cases:

  • num, exponent or modulus is not a well-formed BCMath numeric string
  • num, exponent or modulus has a fractional part
  • exponent is a negative value
  • scale is outside the valid range

This function throws a DivisionByZeroError exception if modulus is 0.

更新日志

版本 说明
8.0.0 scale is now nullable.
8.0.0 Now throws a ValueError instead of returning false if exponent is a negative value.
8.0.0 Dividing by 0 now throws a DivisionByZeroError exception instead of returning false.

示例

The following two statements are functionally identical. The bcpowmod() version however, executes in less time and can accept larger parameters.

<?php
$a = bcpowmod($x, $y, $mod);

$b = bcmod(bcpow($x, $y), $mod);

// $a and $b are equal to each other.

?>

注释

注意:

Because this method uses the modulus operation, numbers which are not positive integers may give unexpected results.

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。