bcmod

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

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

Описание

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

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

Список параметров

num1

Левый операнд (слагаемое) в виде строки.

num2

Правый операнд (слагаемое) в виде строки.

scale
Параметр устанавливает количество знаков после десятичного разделителя, которое вернётся в результате. При значении null количество знаков после десятичного разделителя равняется значению по умолчанию, которое установили для параметра глобально функцией bcscale(), или резервному значению, которое указали в INI-директиве 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() - Получает коэффициент и модуль числа произвольной точности