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() - Получает коэффициент и модуль числа произвольной точности

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 2 notes

down

lauris at night dot lt ¶

20 years ago

<?php

/**

 * my_bcmod - get modulus (substitute for bcmod)

 * string my_bcmod ( string left_operand, int modulus )

 * left_operand can be really big, but be carefull with modulus :(

 * by Andrius Baranauskas and Laurynas Butkus :) Vilnius, Lithuania

 **/

function my_bcmod( $x, $y )

{

    // how many numbers to take at once? carefull not to exceed (int)

    $take = 5;     

    $mod = '';



    do

    {

        $a = (int)$mod.substr( $x, 0, $take );

        $x = substr( $x, $take );

        $mod = $a % $y;    

    } 

    while ( strlen($x) );



    return (int)$mod;

}



// example

echo my_bcmod( "7044060001970316212900", 150 );

?>

down

drahoszdenek at gmail dot com ¶

11 years ago

The modulus can be only integer. For "floats" bcmod returns 0:

<?php
echo bcmod('10', '2.1'); // 0
?>

For real modulus you can use BN-PHP project (hosted at Bitbucket):

<?php
$eval = new \BN\Expression\ExpressionEvaluator();
$operators = new \BN\Expression\OperatorsFactory();
$eval->setOperators($operators->getOperators(array('%')));
        
echo $eval->evaluate('10 % 2.1'); // 1.6
echo $eval->evaluate('10 % -2.1'); // 1.6
echo $eval->evaluate('-10 % 2.1'); // -1.6
echo $eval->evaluate('-10 % -2.1'); // -1.6
?>

＋Добавить