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 é usado para definir o número de dígitos após o separador de decimais do resultado. Se for null, será usada a escala padrão definida com bcscale(), ou será usado 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
    • BcMath\Number::mod() - Obtém o resto de um número de precisão arbitrária

    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
    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?>
    ＋adicione uma nota
    To Top