Iterate Through Dictionary Python Deep Dive!

In Python, a dictionary is a data structure that stores key-value pairs. Each key in a dictionary is unique and maps to a corresponding value. Iterating through a dictionary is a common task, whether you’re processing data, filtering content, or accessing both keys and values for computations.

By the end of this guide, you will have a deep understanding of how to iterate through a dictionary in Python and when to use each method for different tasks.

What is a Dictionary in Python?

A dictionary in Python is an unordered collection of key-value pairs, where each key is unique. Dictionaries are mutable, meaning you can modify them after creation by adding, removing, or updating key-value pairs.

Example of a Python Dictionary:

my_dict = {
    "name": "Alice",
    "age": 25,
    "city": "New York"
}

In this example, "name", "age", and "city" are the keys, and "Alice", 25, and "New York" are their corresponding values.

Different Ways to Iterate Through a Dictionary in Python

1. Iterating Through Dictionary Keys

The simplest way to iterate through a dictionary is by looping over its keys. By default, when you loop through a dictionary, Python returns the keys.

Example: Iterating Over Keys

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for key in my_dict:
    print(key)

Output:

name
age
city

You can also explicitly use the keys() method to iterate over the keys.

Example Using `keys()` Method:

for key in my_dict.keys():
    print(key)

This method returns a view object that displays a list of all keys in the dictionary.

2. Iterating Through Dictionary Values

If you want to iterate through the values of the dictionary instead of the keys, you can use the values() method.

Example: Iterating Over Values

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for value in my_dict.values():
    print(value)

Output:

Alice
25
New York

This method allows you to access only the values in the dictionary, without the keys.

3. Iterating Through Key-Value Pairs

To iterate over both keys and values simultaneously, you can use the items() method, which returns a view object containing tuples of key-value pairs.

Example: Iterating Over Key-Value Pairs

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for key, value in my_dict.items():
    print(f"Key: {key}, Value: {value}")

Output:

Key: name, Value: Alice
Key: age, Value: 25
Key: city, Value: New York

This is the most common way to access both keys and their corresponding values during iteration.

4. Iterating Through Dictionary Keys in a Sorted Order

Dictionaries in Python (version 3.7 and above) maintain the insertion order of keys. However, if you want to iterate through the keys in a sorted order, you can use the sorted() function.

Example: Iterating Over Keys in a Sorted Order

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for key in sorted(my_dict):
    print(f"Key: {key}, Value: {my_dict[key]}")

Output:

Key: age, Value: 25
Key: city, Value: New York
Key: name, Value: Alice

This sorts the dictionary keys alphabetically (or numerically if they are numbers) before iterating.

5. Iterating Through a Dictionary Using `enumerate()`

If you need to keep track of the index during iteration, you can use the enumerate() function to get both the index and the key-value pairs.

Example: Iterating with Index Using `enumerate()`

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for index, (key, value) in enumerate(my_dict.items()):
    print(f"Index: {index}, Key: {key}, Value: {value}")

Output:

Index: 0, Key: name, Value: Alice
Index: 1, Key: age, Value: 25
Index: 2, Key: city, Value: New York

Using enumerate() is useful when you need both the position of the key-value pair and the pair itself.

6. Iterating Through Nested Dictionaries

A nested dictionary is a dictionary within a dictionary. When iterating through a nested dictionary, you may need to use nested loops to access the inner dictionaries.

Example: Iterating Over a Nested Dictionary

nested_dict = {
    "person1": {"name": "Alice", "age": 25},
    "person2": {"name": "Bob", "age": 30}
}

for key, value in nested_dict.items():
    print(f"Outer Key: {key}")
    for inner_key, inner_value in value.items():
        print(f"  Inner Key: {inner_key}, Inner Value: {inner_value}")

Output:

Outer Key: person1
  Inner Key: name, Inner Value: Alice
  Inner Key: age, Inner Value: 25
Outer Key: person2
  Inner Key: name, Inner Value: Bob
  Inner Key: age, Inner Value: 30

In this case, you first iterate over the outer dictionary, then iterate through each inner dictionary.

7. Iterating Through Dictionary in Reverse Order

To iterate through a dictionary in reverse order, you can use the reversed() function along with the sorted() function (if you want sorted reverse order) or simply reverse the order of keys using slicing.

Example: Iterating in Reverse Order

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for key in reversed(my_dict):
    print(f"Key: {key}, Value: {my_dict[key]}")

Output:

Key: city, Value: New York
Key: age, Value: 25
Key: name, Value: Alice

This reverses the order in which the keys are iterated over.

Best Practices for Iterating Through a Dictionary

1. Use `items()` When You Need Both Keys and Values

When you need to access both the keys and values of a dictionary during iteration, always use the items() method. It is more efficient and concise compared to accessing values manually inside the loop.

Example:

for key, value in my_dict.items():
    # Do something with key and value
    pass

2. Avoid Modifying the Dictionary While Iterating

Modifying a dictionary (e.g., adding or removing elements) while iterating through it can lead to unpredictable behavior and runtime errors. If you need to modify the dictionary, consider creating a copy or collecting keys for modification in a separate list.

Example of Safe Modification:

# Create a list of keys to remove
keys_to_remove = [key for key in my_dict if my_dict[key] == "value_to_remove"]

# Remove keys after iteration
for key in keys_to_remove:
    del my_dict[key]

3. Use `enumerate()` If You Need Index Tracking

If your logic requires you to keep track of the index of items while iterating, use the enumerate() function, which allows you to track the position of key-value pairs efficiently.

Common Use Cases for Iterating Through a Dictionary

1. Summing Values in a Dictionary

You can iterate through the values of a dictionary to calculate sums, averages, or other aggregates.

Example: Summing Dictionary Values

scores = {"Alice": 85, "Bob": 90, "Charlie": 78}

total_score = sum(scores.values())
print(total_score)  # Output: 253

2. Filtering a Dictionary

You can iterate through a dictionary and create a new dictionary that meets certain conditions (e.g., filtering out entries with specific values).

Example: Filtering a Dictionary

my_dict = {"Alice": 85, "Bob": 90, "Charlie": 78}

filtered_dict = {k: v for k, v in my_dict.items() if v >= 80}
print(filtered_dict)  # Output: {'Alice': 85, 'Bob': 90}

Common Pitfalls When Iterating Through a Dictionary

1. Modifying the Dictionary During Iteration

Modifying the structure of a dictionary (adding/removing keys) while iterating can lead to a RuntimeError or incorrect results. If modification is necessary, make sure to iterate over a copy of the dictionary or store keys for later modification.

2. Confusing Keys and Values

When using a loop to iterate through a dictionary, it’s easy to accidentally mix up keys and values. Ensure you use the correct methods—keys(), values(), or items()—depending on what you need to iterate over.

3. Unintended Changes in Key Order

While Python dictionaries maintain insertion order (as of Python 3.7+), sorting keys manually can lead to unintended changes in the order of iteration. Be mindful of the need to preserve or modify the order of keys during iteration.

Summary of Key Concepts

Dictionaries are a key-value store in Python, and there are multiple ways to iterate through a dictionary:
keys(): Iterate over keys.
values(): Iterate over values.
items(): Iterate over both keys and values.
Use items() for the most common use case—accessing both keys and values.
For specific order requirements, you can sort or reverse the keys during iteration.
Avoid modifying the dictionary while iterating to prevent errors.

Exercises

Basic Dictionary Iteration: Write a Python function that iterates through a dictionary and prints each key and its corresponding value.
Filter Dictionary: Create a Python function that filters out entries from a dictionary where the value is below a certain threshold.
Nested Dictionary Iteration: Write a Python program to iterate through a nested dictionary and print all keys and values at every level.

Lightning bolt and Python code snippet with "LEARN PYTHON PROGRAMMING MASTERCLASS" in blocky caps

Check out our FREE Learn Python Programming Masterclass to hone your skills or learn from scratch.

The course covers everything from first principles to Graphical User Interfaces and Machine Learning

You can check out the official Python documentation here.

FAQ

Q1: Can I modify a dictionary while iterating through it?

A1: No, modifying a dictionary (e.g., adding or removing keys) while iterating through it can result in a RuntimeError. If you need to modify a dictionary during iteration, consider iterating over a copy of the dictionary or storing the keys to modify in a separate list, then make changes after the iteration.

Example: Modifying a Dictionary Safely

my_dict = {"name": "Alice", "age": 25, "city": "New York"}
keys_to_remove = [key for key in my_dict if my_dict[key] == "New York"]

for key in keys_to_remove:
    del my_dict[key]

print(my_dict)  # Output: {'name': 'Alice', 'age': 25}

Q2: Can I iterate over a dictionary in reverse order?

A2: Yes, you can iterate over a dictionary in reverse order by using the reversed() function in combination with the keys(), values(), or items() methods. However, dictionaries (from Python 3.7+) maintain insertion order, so reversing the dictionary depends on the order the elements were added.

Example: Reversing Dictionary Iteration

my_dict = {"name": "Alice", "age": 25, "city": "New York"}
for key in reversed(my_dict):
    print(f"Key: {key}, Value: {my_dict[key]}")

Q3: How do I iterate over a dictionary and remove items based on a condition?

A3: To safely remove items from a dictionary while iterating, you should iterate over a copy of the dictionary or store the keys to be removed in a separate list, and then delete them after the iteration is complete.

Example: Removing Items Based on a Condition

my_dict = {"name": "Alice", "age": 25, "city": "New York"}
keys_to_remove = [key for key, value in my_dict.items() if value == "New York"]

for key in keys_to_remove:
    del my_dict[key]

print(my_dict)  # Output: {'name': 'Alice', 'age': 25}

Q4: Can I use `enumerate()` with dictionaries to get the index of each key-value pair?

A4: Yes, you can use enumerate() with items() to get both the index and the key-value pair while iterating through a dictionary.

Example: Using `enumerate()` with a Dictionary

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for index, (key, value) in enumerate(my_dict.items()):
    print(f"Index: {index}, Key: {key}, Value: {value}")

Output:

Index: 0, Key: name, Value: Alice
Index: 1, Key: age, Value: 25
Index: 2, Key: city, Value: New York

Q5: What happens if I use `items()`, `keys()`, or `values()` on an empty dictionary?

A5: If you use items(), keys(), or values() on an empty dictionary, the methods will return empty view objects. These view objects behave like lists but are lightweight and efficient. You can safely iterate over them, and since the dictionary is empty, nothing will be printed or processed.

Example:

empty_dict = {}
for key in empty_dict.keys():
    print(key)  # This won't print anything since the dictionary is empty

Q6: Can I use `sorted()` on dictionary values or keys while iterating?

A6: Yes, you can use sorted() on either the dictionary’s keys, values, or both while iterating. Sorting will create a sorted list from the dictionary’s keys or values before you begin iteration.

Example: Sorting Keys While Iterating

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

for key in sorted(my_dict):
    print(f"Key: {key}, Value: {my_dict[key]}")

Output:

Key: age, Value: 25
Key: city, Value: New York
Key: name, Value: Alice

Q7: How do I iterate through a nested dictionary in Python?

A7: To iterate through a nested dictionary, you need to use a nested loop. First, loop through the outer dictionary, and for each key-value pair where the value is another dictionary, you can loop through the inner dictionary.

Example: Iterating Through a Nested Dictionary

nested_dict = {
    "person1": {"name": "Alice", "age": 25},
    "person2": {"name": "Bob", "age": 30}
}

for outer_key, inner_dict in nested_dict.items():
    print(f"Outer Key: {outer_key}")
    for inner_key, inner_value in inner_dict.items():
        print(f"  Inner Key: {inner_key}, Inner Value: {inner_value}")

Q8: How can I iterate through only certain dictionary keys (filtered keys)?

A8: You can use a loop with a condition to iterate through only specific keys that meet certain criteria, or create a filtered list of keys beforehand and iterate through that list.

Example: Iterating Through Filtered Keys

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

# Only iterate through keys that start with 'c'
for key in [k for k in my_dict if k.startswith('c')]:
    print(f"Key: {key}, Value: {my_dict[key]}")

Output:

Key: city, Value: New York

Q9: Can I convert a dictionary to a list and iterate through it?

A9: Yes, you can convert a dictionary’s keys, values, or key-value pairs (as tuples) into a list and iterate through that list. This is useful if you need to perform list-based operations on a dictionary.

Example: Converting a Dictionary to a List of Tuples

my_dict = {"name": "Alice", "age": 25, "city": "New York"}

# Convert dictionary to a list of tuples
dict_items = list(my_dict.items())

for item in dict_items:
    print(item)

Output:

('name', 'Alice')
('age', 25)
('city', 'New York')

Q10: Can I use `for` loops to iterate through dictionaries in Python 2?

A10: In Python 2, items(), keys(), and values() return lists rather than view objects (as they do in Python 3). For large dictionaries, this can be inefficient in Python 2. To avoid this, use iteritems(), iterkeys(), and itervalues(), which return iterators instead of lists.

Example in Python 2:

# Python 2 code
for key, value in my_dict.iteritems():
    print(key, value)

In Python 3, items(), keys(), and values() already return efficient view objects, so iteritems(), iterkeys(), and itervalues() are no longer needed.

Table of Contents

What is a Dictionary in Python?

Example of a Python Dictionary:

Different Ways to Iterate Through a Dictionary in Python

1. Iterating Through Dictionary Keys

Example: Iterating Over Keys

Output:

Example Using keys() Method:

2. Iterating Through Dictionary Values

Example: Iterating Over Values

Output:

3. Iterating Through Key-Value Pairs

Example: Iterating Over Key-Value Pairs

Output:

4. Iterating Through Dictionary Keys in a Sorted Order

Example: Iterating Over Keys in a Sorted Order

Output:

5. Iterating Through a Dictionary Using enumerate()

Example: Iterating with Index Using enumerate()

Output:

6. Iterating Through Nested Dictionaries

Example: Iterating Over a Nested Dictionary

Output:

7. Iterating Through Dictionary in Reverse Order

Example: Iterating in Reverse Order

Output:

Best Practices for Iterating Through a Dictionary

1. Use items() When You Need Both Keys and Values

Example:

2. Avoid Modifying the Dictionary While Iterating

Example of Safe Modification:

3. Use enumerate() If You Need Index Tracking

Common Use Cases for Iterating Through a Dictionary

1. Summing Values in a Dictionary

Example: Summing Dictionary Values

2. Filtering a Dictionary

Example: Filtering a Dictionary

Common Pitfalls When Iterating Through a Dictionary

1. Modifying the Dictionary During Iteration

2. Confusing Keys and Values

3. Unintended Changes in Key Order

Summary of Key Concepts

Exercises

FAQ

Q1: Can I modify a dictionary while iterating through it?

Example: Modifying a Dictionary Safely

Q2: Can I iterate over a dictionary in reverse order?

Example: Reversing Dictionary Iteration

Q3: How do I iterate over a dictionary and remove items based on a condition?

Example: Removing Items Based on a Condition

Q4: Can I use enumerate() with dictionaries to get the index of each key-value pair?

Example: Using enumerate() with a Dictionary

Output:

Q5: What happens if I use items(), keys(), or values() on an empty dictionary?

Example:

Q6: Can I use sorted() on dictionary values or keys while iterating?

Example: Sorting Keys While Iterating

Output:

Q7: How do I iterate through a nested dictionary in Python?

Example: Iterating Through a Nested Dictionary

Q8: How can I iterate through only certain dictionary keys (filtered keys)?

Example: Iterating Through Filtered Keys

Output:

Q9: Can I convert a dictionary to a list and iterate through it?

Example: Converting a Dictionary to a List of Tuples

Output:

Q10: Can I use for loops to iterate through dictionaries in Python 2?

Example in Python 2:

Similar Posts

Example Using `keys()` Method:

5. Iterating Through a Dictionary Using `enumerate()`

Example: Iterating with Index Using `enumerate()`

1. Use `items()` When You Need Both Keys and Values

3. Use `enumerate()` If You Need Index Tracking

Q4: Can I use `enumerate()` with dictionaries to get the index of each key-value pair?

Example: Using `enumerate()` with a Dictionary

Q5: What happens if I use `items()`, `keys()`, or `values()` on an empty dictionary?

Q6: Can I use `sorted()` on dictionary values or keys while iterating?

Q10: Can I use `for` loops to iterate through dictionaries in Python 2?