bcmod

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

bcmodObtém o módulo de um número 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. A não ser que num2 seja zero, o resultado tem o mesmo sinal que num1.

Parâmetros

num1

O número dividendo, como string.

num2

O número divisor, como string.

Valor Retornado

Retorna o módulo como uma string, ou null se num2 é 0.

Registro de Alterações

Versão Descrição
8.0.0 scale pode ser 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

Example #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
?>

Example #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() - Dividir dois números de precisão arbitrária