Altcademy - a Forbes magazine logo Best Coding Bootcamp 2023

What is mod in Python

Understanding the Modulo Operation

The modulo operation, often abbreviated as 'mod', might sound intimidating at first, but it's a fundamental concept in programming that can be very useful in a variety of situations. To give you an intuition about what the modulo operation does, imagine you have a clock with only 12 hours on it. If it's 8 o'clock now and you want to know what time it will be 5 hours later, you add 5 to 8 and get 13. But there's no 13 on the clock! Instead, you wrap around and end up at 1 o'clock. This "wrapping around" is essentially what the modulo operation does: it finds the remainder after division of one number by another.

In Python, the modulo operation is performed using the % symbol. Let's see this in action with some code:

# Using the modulo operation to find the remainder
remainder = 13 % 12
print(remainder)  # Output will be 1

Here, 13 % 12 is asking "what's the remainder when 13 is divided by 12?" The answer is 1, just like on our clock analogy.

Modulo with Positive Integers

Let's start with the simplest case: using the modulo operation with positive integers.

# Example of modulo with positive integers
print(10 % 3)  # Output will be 1
print(18 % 7)  # Output will be 4
print(5 % 5)   # Output will be 0

In the first line, 10 % 3 is asking "if you divide 10 by 3, what's left over?" Since 3 goes into 10 three times with 1 left over, the result is 1.

In the second example, 18 % 7 is similar: 7 goes into 18 twice, with a remainder of 4.

In the third example, 5 % 5 is a special case. Since 5 divides evenly into 5, there's nothing left over, so the result is 0.

Modulo with Negative Numbers

Things get a bit more interesting when negative numbers are involved. In Python, the sign of the result matches the divisor (the number after the %).

# Example of modulo with negative numbers
print(-10 % 3)  # Output will be 2
print(10 % -3)  # Output will be -2

In the first line, -10 % 3 means "if you divide -10 by 3, what's the remainder?" You might think it's -1, but Python makes it 2, because it's the smallest positive remainder you can have after division.

In the second line, 10 % -3 gives us -2. This is because Python is looking for the remainder that will make the result as close to zero as possible, but on the negative side since the divisor is negative.

Practical Applications of Modulo

The modulo operation isn't just a mathematical curiosity; it has practical applications in programming. For example, it's often used to determine if a number is even or odd:

# Determining if a number is even or odd
number = 7
if number % 2 == 0:
    print("The number is even.")
    print("The number is odd.")

Here, number % 2 checks the remainder when number is divided by 2. If it's 0, the number is even; otherwise, it's odd.

Another common use is in dealing with circular data structures or wrapping around in arrays or lists:

# Wrapping around a list using modulo
colors = ['red', 'green', 'blue']
position = 8
print(colors[position % len(colors)])  # Output will be 'green'

Since there are only 3 colors, asking for the color at position 8 doesn't make sense. But position % len(colors) calculates the remainder when 8 is divided by 3, which is 2, corresponding to 'green'.

Modulo and Mathematical Properties

The modulo operation has some interesting properties that are worth knowing:

  1. (a + b) % n = ((a % n) + (b % n)) % n
  2. (a * b) % n = ((a % n) * (b % n)) % n

These properties can often simplify calculations and make your code more efficient. Let's see some examples:

# Simplifying calculations using modulo properties
a, b, n = 5, 3, 2
result1 = (a + b) % n
result2 = ((a % n) + (b % n)) % n
print(result1 == result2)  # Output will be True

result3 = (a * b) % n
result4 = ((a % n) * (b % n)) % n
print(result3 == result4)  # Output will be True

In both cases, the results are the same whether we perform the operation on the original numbers or on their remainders.

Modulo in Real-World Problems

Beyond simple examples, the modulo operation is used in real-world applications such as cryptography, hashing algorithms, and random number generation. It's also central in algorithms for balancing loads across servers or in designing repeating patterns.

For instance, consider a scenario where you're building a scheduling system and you need to assign tasks to different days of the week in a repeating cycle:

# Assigning tasks to different days using modulo
tasks = ['Task A', 'Task B', 'Task C', 'Task D']
day_of_week = 3  # Let's say it's Wednesday (0 = Sunday, 1 = Monday, etc.)

task_for_today = tasks[day_of_week % len(tasks)]
print(f"Today's task is: {task_for_today}")

Here, we ensure that no matter what the day_of_week is, we'll always get one of the tasks from our list, cycling through them as the week progresses.


The modulo operation is a powerful tool in Python that extends far beyond simple arithmetic. It's the key to solving many types of problems, from the everyday to the complex. Whether you're determining the day of the week, creating a game, or working on an advanced algorithm, understanding and utilizing the modulo operation can help you write smarter and more efficient code.

As you continue your journey in programming, remember that concepts like modulo are building blocks. Just like the individual gears in a clock, they may seem small on their own, but they work together to drive the larger mechanism. Keep experimenting with these building blocks, and you'll be amazed at the intricate systems you can build. Happy coding!