bcmod

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

bcmod — 任意精度数字取模

说明

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 ¶

21 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 ¶

12 years ago

The modulus can be only integer. For "floats" bcmod returns 0:<?phpecho 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.6echo $eval->evaluate('10 % -2.1'); // 1.6echo $eval->evaluate('-10 % 2.1'); // -1.6echo $eval->evaluate('-10 % -2.1'); // -1.6?>