fmod()

Сегодня мы рассмотрим функцию fmod() в PHP. Она используется для получения остатка от деления двух чисел.

Что такое функция fmod()?

Функция fmod() в PHP — это встроенная функция, которая возвращает остаток от деления двух чисел. Функция принимает два числа в качестве аргументов и возвращает остаток от деления в виде числа с плавающей точкой.

Синтаксис и параметры

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

• $num1: Делимое.
• $num2: Делитель.

Возвращаемое значение: Возвращает остаток от деления $num1 / $num2 в виде числа с плавающей точкой. Если $num2 равен 0, функция возвращает NAN.

Как использовать функцию fmod()

Использовать функцию fmod() в PHP очень просто. Вот пример того, как применять эту функцию:

В этом примере мы задаём два числа как переменные. Затем вызываем функцию fmod() с двумя числами в качестве параметров, чтобы получить остаток от деления. Наконец, выводим остаток на экран. Результат равен 1.

Работа с десятичными числами

Поскольку fmod() сохраняет дробную часть, это правильный инструмент, когда операнды не являются целыми числами. Оператор % молча усечёт их до целых и даст вводящий в заблуждение результат.

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

Сравнение с оператором %

Хотя оператор % также вычисляет остатки, он работает только с целыми числами. Функция fmod() работает как с целыми числами, так и с числами с плавающей точкой, что делает её более универсальной для математических вычислений с десятичными числами. Если вам действительно нужно целочисленное деление, используйте intdiv() для получения частного и % для остатка.

Граничные случаи

• Отрицательные операнды: fmod() сохраняет знак делимого. Например, fmod(-5, 2) возвращает -1.
• Деление на ноль: Если делитель равен 0, fmod() возвращает NAN (Not a Number) вместо того, чтобы выбрасывать ошибку. Проверяйте это с помощью is_nan() перед использованием результата.

Распространённое практическое применение — приведение значения к диапазону, например нормализация угла до 0–360 градусов:

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

Если после этого нужно округлить результат, воспользуйтесь функциями round(), floor() или ceil().

Заключение

Функция fmod() в PHP — полезный инструмент для любого PHP-разработчика, работающего с операциями деления. С её помощью можно получить остаток от деления двух чисел, что может быть полезно в самых разных задачах. Мы надеемся, что это руководство помогло вам понять, как использовать функцию fmod() в вашем PHP-коде. Она особенно удобна для таких задач, как вычисления со временем, циклическая индексация массивов и работа с дробными остатками, где оператор % не справляется.

Практика