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

down

lauris at night dot lt ¶

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

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