PHP Conference Nagoya 2025

bcmod

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

bcmodObté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 é uma string numérica BCMath bem formada.
  • scale está 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

adicione uma nota

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

up
4
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 );
?>
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
?>
To Top