bcmod

(PHP 4, PHP 5, PHP 7, PHP 8)

bcmod — 任意精度数字取模

说明

function bcmod(string $num1, string $num2, ? int $scale = null ): string

对 num1 使用 num2 取模。结果与 num1 的符号相同。

参数

num1: 左操作数,字符串类型。
num2: 右操作数,字符串类型。
scale: 此参数用于设置结果小数点后的位数。如果为 null ,则默认为使用 bcscale() 设置的默认精度, 或者回退到 bcmath.scale INI 指令的值。

返回值

返回字符串类型取模后的结果。

错误/异常

此函数在下列情况下抛出 ValueError :

num1 或 num2 不是格式正确的 BCMath 数字字符串。
scale 超出有效范围。

如果 num2 为 0,此函数会抛出 DivisionByZeroError 异常。

更新日志

版本	说明
8.0.0	现在 `scale` 可以为 null。
8.0.0	现在,除以 `0` 会引发 DivisionByZeroError 异常,而不是返回 `null` 。
7.2.0	现在 `num1` 和 `num2` 不会截断成整数。所以现在 bcmod() 的表现更接近 fmod() 而不是 `%` 操作符。
7.2.0	新增参数 `scale`。

示例

示例 #1 bcmod() 示例

<?php
bcscale(0);
echo bcmod( '5', '3'); // 2
echo bcmod( '5', '-3'); // 2
echo bcmod('-5', '3'); // -2
echo bcmod('-5', '-3'); // -2
?>

示例 #2 带小数点的 bcmod()

<?php
bcscale(1);
echo bcmod('5.7', '1.3'); // PHP 7.2.0 起是 0.5;之前是 0
?>

参见

bcdiv() - 两个任意精度的数字除法计算
bcdivmod() - Get the quotient and modulus of an arbitrary precision number
BcMath\Number::mod() - Gets the modulus of an arbitrary precision number

发现了问题?

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

+添加备注

用户贡献的备注 2 notes

down

lauris at night dot lt ¶

22 years ago

<?php
/**
 * my_bcmod - get modulus (substitute for bcmod)
 * string my_bcmod ( string left_operand, int modulus )
 * left_operand can be really big, but be carefull with modulus :(
 * by Andrius Baranauskas and Laurynas Butkus :) Vilnius, Lithuania
 **/
function my_bcmod( $x, $y )
{
 // how many numbers to take at once? carefull not to exceed (int)
 $take = 5; 
 $mod = '';
 do
 {
 $a = (int)$mod.substr( $x, 0, $take );
 $x = substr( $x, $take );
 $mod = $a % $y; 
 } 
 while ( strlen($x) );
 return (int)$mod;
}
// example
echo my_bcmod( "7044060001970316212900", 150 );
?>

down

drahoszdenek at gmail dot com ¶

13 years ago

The modulus can be only integer. For "floats" bcmod returns 0:
<?php
echo bcmod('10', '2.1'); // 0
?>

For real modulus you can use BN-PHP project (hosted at Bitbucket):
<?php
$eval = new \BN\Expression\ExpressionEvaluator();
$operators = new \BN\Expression\OperatorsFactory();
$eval->setOperators($operators->getOperators(array('%')));
 
echo $eval->evaluate('10 % 2.1'); // 1.6
echo $eval->evaluate('10 % -2.1'); // 1.6
echo $eval->evaluate('-10 % 2.1'); // -1.6
echo $eval->evaluate('-10 % -2.1'); // -1.6
?>