PHP Conference Japan 2024

    bcmod

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

    bcmod — 取得任意精度數字的模數

    說明

    bcmod(字串 $num1, 字串 $num2, ?整數 $scale = null): 字串

    取得 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'); // 0.5 從 PHP 7.2.0 開始；之前為 0
    ?>

    參見

    • bcdiv() - 兩個任意精度數的除法
    • bcdivmod() - 取得任意精度數的商數和餘數

    發現問題了嗎？

    學習如何改進此頁面 • 提交拉取請求 • 回報錯誤
    ＋新增筆記

    使用者貢獻的筆記 2 則筆記

    4
    lauris at night dot lt
    20 年前
    <?php
    /**
    * my_bcmod - 取得餘數（bcmod 的替代方案）
    * string my_bcmod ( string left_operand, int modulus )
    * left_operand 可以非常大，但要注意 modulus :(
    * 作者：Andrius Baranauskas 和 Laurynas Butkus :) 維爾紐斯，立陶宛
    **/
    function my_bcmod( $x, $y )
    {
    // 一次取多少個數字？小心不要超過 (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;
    }

    // 範例
    echo my_bcmod( "7044060001970316212900", 150 );
    ?>
    1
    drahoszdenek at gmail dot com
    11 年前
    除數只能是整數。對於「浮點數」，bcmod 會回傳 0

    <?php
    echo bcmod('10', '2.1'); // 0
    ?>

    若要處理真正的浮點數取模，您可以使用 BN-PHP 專案（託管於 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
    ?>
    ＋新增筆記
    To Top