fmod()

Hoje, vamos discutir a função fmod() no PHP. Esta função é utilizada para obter o resto de uma operação de divisão entre dois números.

O que é a Função fmod()?

A função fmod() no PHP é uma função nativa usada para obter o resto de uma operação de divisão entre dois números. A função recebe dois números como entrada e retorna o resto da operação de divisão como um número de ponto flutuante.

Sintaxe e Parâmetros

fmod(float $num1, float $num2): float

• $num1: O dividendo.
• $num2: O divisor.

Valor de Retorno: Retorna o resto de ponto flutuante de $num1 / $num2. Se $num2 for 0, a função retorna NAN.

Como Usar a Função fmod()

Usar a função fmod() no PHP é muito simples. Veja um exemplo de como utilizar a função:

Neste exemplo, definimos dois números como variáveis. Em seguida, chamamos a função fmod() com os dois números como parâmetros para obter o resto da operação de divisão. Por fim, exibimos o resto na tela. O resultado exato é 1.

Trabalhando com Decimais

Como o fmod() preserva a parte de ponto flutuante, ele é a ferramenta certa sempre que os operandos não são números inteiros. O operador % truncaria silenciosamente os valores para inteiros primeiro e produziria um resultado equivocado.

<?php
echo fmod(7.5, 2);   // 1.5 — the leftover after fitting 2 into 7.5 three times
echo "\n";
echo 7.5 % 2;        // 1   — operands are cast to int (7 % 2), losing the decimal
?>

Comparação com o Operador %

Embora o operador % também calcule restos, ele só funciona com inteiros. A função fmod() funciona com inteiros e números de ponto flutuante, tornando-a mais versátil para cálculos matemáticos que envolvem decimais. Se você realmente precisar de divisão inteira, use intdiv() para o quociente e % para o resto.

Casos Extremos

• Operandos Negativos: O fmod() preserva o sinal do dividendo. Por exemplo, fmod(-5, 2) retorna -1.
• Divisão por Zero: Se o divisor for 0, o fmod() retorna NAN (Not a Number) em vez de lançar um erro. Verifique isso com is_nan() antes de usar o resultado.

Um uso prático comum é encaixar um valor em um intervalo — por exemplo, normalizar um ângulo para 0–360 graus:

<?php
$angle = 725;
echo fmod($angle, 360); // 5
?>

Se você precisar arredondar o resultado depois, utilize round(), floor() ou ceil().

Conclusão

A função fmod() no PHP é uma ferramenta útil para qualquer desenvolvedor PHP que trabalha com operações de divisão. Ao usar essa função, você pode obter o resto de uma operação de divisão entre dois números, o que pode ser útil em diversas aplicações. Esperamos que este guia tenha sido útil para entender como usar a função fmod() no seu código PHP. Ela é especialmente conveniente para tarefas como cálculos de tempo, indexação cíclica de arrays e tratamento de restos decimais onde o operador % é insuficiente.

Prática