Python math.fmod(): Float Modulo vs. % Operator

Syntax & Parameters 🔝

The math.fmod() function requires importing the math module and accepts two arguments:

import math

remainder = math.fmod(x, y)

Return Value: Returns a floating-point number (float) representing x - n * y, where n is x / y truncated towards zero.

Basic Examples 🔝

Basic division with positive integers and floating-point values:

import math

print(math.fmod(10, 2))    # Output: 0.0
print(math.fmod(10, 3))    # Output: 1.0
print(math.fmod(10.5, 4))  # Output: 2.5

0.0
1.0
2.5

Notice that the return value is always a float, even when passing integer arguments.

fmod() vs. % Operator: Negative Number Sign Rules 🔝

The most important distinction in Python mathematics is how math.fmod() differs from the built-in % operator when negative numbers are involved:

• math.fmod(x, y): Uses truncated division (truncates towards zero). The remainder always carries the sign of x (dividend).
• x % y: Uses floored division (rounds down towards negative infinity). The remainder always carries the sign of y (divisor).

import math

x, y = -25, 3
print("math.fmod(-25, 3):", math.fmod(x, y))  # Output: -1.0
print("-25 % 3:         ", x % y)          # Output: 2

Floating-Point Precision & math.isclose() 🔝

Due to standard binary floating-point representation (IEEE 754), fractional modulo operations can yield numbers with tiny trailing decimal imprecisions:

import math

res = math.fmod(10.5, 3.2)
print("Raw result:", res)  # 0.8999999999999995 instead of exact 0.9

# Best Practice: Use math.isclose() for floating-point comparisons
print("Is close to 0.9?", math.isclose(res, 0.9))  # True

Zero Division & ValueError Handling 🔝

A notable difference between math.fmod() and % is the exception raised when the divisor is zero:

• Passing 0 as divisor to math.fmod(x, 0) raises a ValueError: math domain error.
• In contrast, evaluating x % 0 raises a ZeroDivisionError.

import math

try:
    math.fmod(10, 0)
except ValueError as err:
    print("Caught expected domain error:", err)
# Output: Caught expected domain error: math domain error

Hands-on Exercise: Symmetric Angle Normalizer with Assertions 🔝

In robotics, drone navigation, and video games, angles often accumulate beyond full rotations (e.g. $+540^\circ$ or $-750^\circ$). We frequently need to wrap angles into a symmetric span from $-180^\circ$ to $+180^\circ$. Let's build an angle normalizer using math.fmod() verified with unit assertions:

import math

def normalize_heading(angle):
    # Wrap angle into range [-180, 180)
    wrapped = math.fmod(angle + 180, 360)
    if wrapped < 0:
        wrapped += 360
    return wrapped - 180

# Unit Assertions
assert normalize_heading(0) == 0.0
assert normalize_heading(190) == -170.0
assert normalize_heading(-200) == 160.0
assert normalize_heading(360) == 0.0
assert normalize_heading(725) == 5.0

print("Heading for 190 deg: ", normalize_heading(190))
print("Heading for -200 deg:", normalize_heading(-200))
print("All heading normalizer assertions passed successfully!")

Practice in Google Colab & GitHub 🔝

Open in Google Colab View on GitHub

Run all math.fmod() examples interactively, contrast negative sign behaviors with %, and verify the heading normalizer with unit assertions directly in Google Colab.

More Details & Related Guides 🔝

• Python Math Module Overview — Complete index of mathematical, geometric, and numeric functions.
• math.remainder() Function — IEEE 754 remainder rounded to the nearest integer.
• math.floor() & math.ceil() — Rounding numbers down and up to integer bounds.
• math.trunc() Function — Truncating floating-point numbers toward zero.
• Python Operators Guide — Arithmetic, comparison, and bitwise operators in Python.

Subhendu Mohapatra

Author & Instructor at plus2net

I write and maintain practical tutorials on Python, PHP, SQL, JavaScript, HTML, jQuery, and web development at plus2net. The tutorials focus on clear explanations, working examples, and code that readers can test and adapt while learning.

About the author   Watch on YouTube

Connect: