Получает остаток от деления чисел произвольной точности

bcmod(string $num1, string $num2, ?int $scale = null): string

Функция получает остаток от деления числа num1 на число num2. Результат получит тот же знак, что и у числа num1.

num1: Левый операнд (слагаемое) в виде строки.
num2: Правый операнд (слагаемое) в виде строки.
scale: Параметр используется для установки количества цифр после десятичного знака в результате. Если установлено значение null, то по умолчанию будет установлен масштаб по умолчанию, заданный с помощью функции bcscale() или значение INI-директивы bcmath.scale.

Функция возвращает остаток от деления в виде строки.

Функция выбрасывает исключение ValueError в следующих случаях:

Значение аргумента num1 или num2 оказалось строкой, которую сформировали неправильно с точки зрения допустимого формата числовых строк в модуле BCMath.
Значение аргумента scale выходит за пределы допустимого диапазона.

Функция выбрасывает исключение DivisionByZeroError, если число num2 равно 0.

Версия	Описание
8.0.0	Параметр `scale` теперь принимает значение `null`.
8.0.0	Деление на `0` теперь выбрасывает исключение DivisionByZeroError вместо возврата значения `null`.
7.2.0	Числа `num1` и `num2` больше не усекаются до целого, поэтому поведение функции bcmod() теперь соответствует функции fmod(), а не оператору `%`.
7.2.0	Добавили параметр `scale`.

Пример #1 Пример получения остатка от деления функцией bcmod()

<?php

bcscale(0);

echo bcmod( '5',  '3'); //  2
echo bcmod( '5', '-3'); //  2
echo bcmod('-5',  '3'); // -2
echo bcmod('-5', '-3'); // -2

?>

Пример #2 Пример получения остатка от деления чисел с десятичными знаками функцией bcmod()

<?php

bcscale(1);

echo bcmod('5.7', '1.3'); // 0.5 с PHP 7.2.0; 0 ранее

?>

bcdiv() - Делит два числа произвольной точности
bcdivmod() - Получает неполное частное и остаток от деления числа произвольной точности
BcMath\Number::mod() - Получает остаток от деления числа произвольной точности