bcmod

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

bcmod — Devuelve el resto de una división entre números de gran tamaño

Descripción

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

Devuelve el resto de la división entre num1 utilizando num2. El resultado tiene el mismo signo que num1.

Parámetros

num1: El operador izquierdo, como una cadena.
num2: El operador derecho, como una cadena
scale: Este parámetro se utiliza para establecer el número de dígitos después del punto decimal en el resultado. Si es null , se establecerá por defecto en la escala predeterminada establecida con bcscale() , o se utilizará el valor de la directiva INI bcmath.scale.

Valores devueltos

Devuelve el módulo, en forma de string .

Errores/Excepciones

Esta función lanza una excepción ValueError en los siguientes casos:

num1 o num2 no es una cadena numérica bien formada de BCMath.
scale está fuera del rango válido.

Esta función lanza una excepción DivisionByZeroError si num2 es 0.

Historial de cambios

Versión	Descripción
8.0.0	`scale` ahora es nullable.
8.0.0	La división por `0` ahora lanza una excepción DivisionByZeroError en lugar de devolver null.
7.2.0	`num1` y `num2` ya no se truncan a enteros. El comportamiento de bcmod() sigue a fmod() en lugar del operador `%`.
7.2.0	Se ha añadido el parámetro `scale`.

Ejemplos

Ejemplo #1 Ejemplo con bcmod()

<?php
bcscale(0);
echo bcmod( '5', '3'); // 2
echo bcmod( '5', '-3'); // 2
echo bcmod('-5', '3'); // -2
echo bcmod('-5', '-3'); // -2
?>

Ejemplo #2 bcmod() con decimales

<?php
bcscale(1);
echo bcmod('5.7', '1.3'); // 0.5 desde PHP 7.2.0; 0 anteriormente
?>

Véase también

bcdiv() - Divide dos números de precisión arbitraria
bcdivmod() - Devuelve el cociente y el resto de un número de precisión arbitraria
BcMath\Number::mod() - Devuelve el módulo de un número de precisión arbitraria

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 2 notes

down

lauris at night dot lt ¶

22 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 ¶

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

+add a note