math.remainder(x, y)
La función math.remainder devuelve el resto de la división de "x" y de "y" según el criterio impuesto por la norma IEEE 754. Este resto es la diferencia de x-(n*y) para el valor entero n más próximo a la parte entera del cociente x/y (sea mayor o menor que este cociente). Si la parte entera de x/y está a la misma distancia de dos enteros, se considera el entero con valor par (véase ejemplo más adelante).
Obsérvese que este criterio no coincide con el seguido en la función math.fmod.
Se consideran algunos casos especiales. Así, math.remainder(x, math.inf) devuelve x (si x es un número finito) y math.remainder(x, 0) y math.remainder(math.inf, x) devuelven ValueError.
El resultado de la función math.remainder es un número real.
En este primer ejemplo se calcula el resto de la división de los números 6 y 5. En este caso, el cociente 6/5 es 1.2 y el entero más próximo es 1, por lo que el resto a devolver es 6-(1*5) = 1:
math.remainder(6, 5)
1.0
La función math.fmod devuelve el mismo resultado:
math.fmod(6, 5)
1.0
Si pasamos como argumentos a la función los valores 6 y 4, el resultado ya no es exactamente el que podríamos esperar. En este caso el cociente 6/4 es 1.5, por lo que hay dos números enteros a igual distancia de dicho resultado: el número 1 y el número 2. Como se ha comentado, en estos escenarios se considera el número par, el 2, por lo que el resultado de la función es 6-(2*4) = -2:
math.remainder(6, 4)
-2
Este resultado, en efecto, no es el que devuelve la función math.fmod:
math.fmod(6, 4)
2
