bcmod

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

    bcmod — Obtém o resto de uma divisão com precisão arbitrária

    Descrição

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

    Obtém o resto da divisão de num1 por num2. O resultado tem o mesmo sinal de num1.

    Parâmetros

    num1

    O operando da esquerda, como uma string.

    num2

    O operando da direita, como uma string.

    scale
    Este parâmetro opcional é usado para definir o número de dígitos após a casa decimal no resultado. Se for igual a null o padrão será a escala definida com a função bcscale() ou, em último caso, o valor da diretiva INI bcmath.scale.

    Valor Retornado

    Retorna o resto como uma string.

    Erros/Exceções

    Esta função lança uma exceção ValueError nos seguintes casos:

    • num1 ou num2 não for uma string numérica BCMath bem formada.
    • scale estiver fora do intervalo válido.

    Esta função lança uma exceção DivisionByZeroError se num2 for igual a 0.

    Registro de Alterações

    Versão Descrição
    8.0.0 scale pode ser null.
    8.0.0 Dividir por 0 agora lança uma exceção DivisionByZeroError ao invés de retornar null.
    7.2.0 num1 e num2 não são mais truncados para inteiro, de forma que o comportamento de bcmod() é o mesmo de fmod() ao invés do operador %.
    7.2.0 O parâmetro scale foi adicionado.

    Exemplos

    Exemplo #1 Exemplo de bcmod()

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

    Exemplo #2 Exemplo de bcmod() com decimais

    <?php
    bcscale    (1);
    echo     bcmod('5.7', '1.3'); // 0.5 no PHP 7.2.0; anteriormente 0
    ?>

    Veja Também

    • bcdiv() - Divide dois números de precisão arbitrária
    • bcdivmod() - Obtém o quociente e o módulo de um número de precisão arbitrário

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 2 notes

    up
    5
    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 );
    ?>
    up
    1
    drahoszdenek at gmail dot com
    11 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
    ?>
    ＋adicione uma nota
    To Top