Removing dictionary entries in Python

Introduction

Sometimes you want to delete items from a dictionary when they are no longer needed or to clean up data.

You want to remove a user's data after they log out.

You need to delete expired items from a cache.

You want to update a dictionary by removing incorrect or outdated entries.

You want to filter out certain keys from a dictionary before processing.

Syntax

Python

my_dict = {'key1': 'value1', 'key2': 'value2'}

# Remove an entry by key
removed_value = my_dict.pop('key1')

# Remove an entry by key with default if key not found
removed_value = my_dict.pop('key3', None)

# Remove and return an arbitrary item
key, value = my_dict.popitem()

# Delete an entry by key without return
del my_dict['key2']

pop(key) removes the key and returns its value. It raises an error if the key is missing.

pop(key, default) returns default if key is missing instead of error.

Examples

Removes key 'b' and returns its value 2.

Python

my_dict = {'a': 1, 'b': 2, 'c': 3}
removed_value = my_dict.pop('b')
print(my_dict)
print(removed_value)

Key 'z' does not exist, so it returns 'Not found' and dictionary stays the same.

Python

my_dict = {'a': 1}
removed_value = my_dict.pop('z', 'Not found')
print(removed_value)
print(my_dict)

popitem() on empty dictionary raises KeyError.

Python

my_dict = {}
# Using popitem on empty dict raises error
try:
    my_dict.popitem()
except KeyError as error:
    print('Error:', error)

Deletes key 'x' without returning value. Dictionary becomes empty.

Python

my_dict = {'x': 10}
del my_dict['x']
print(my_dict)

Sample Program

This program shows how to remove entries from a dictionary using pop and del. It also shows how to safely try to remove a key that might not exist.

Python

def print_dictionary_state(stage, dictionary):
    print(f"{stage}: {dictionary}")

user_data = {'name': 'Alice', 'age': 30, 'city': 'Wonderland'}
print_dictionary_state('Original dictionary', user_data)

# Remove 'age' using pop
removed_age = user_data.pop('age')
print(f"Removed 'age' with value: {removed_age}")
print_dictionary_state('After removing age', user_data)

# Remove 'city' using del
del user_data['city']
print_dictionary_state('After deleting city', user_data)

# Try to remove 'country' with pop and default
removed_country = user_data.pop('country', 'Not found')
print(f"Attempted to remove 'country', got: {removed_country}")
print_dictionary_state('Final dictionary', user_data)

Important Notes

Time complexity: Removing an entry by key is usually O(1).

Space complexity: No extra space is needed; the dictionary is modified in place.

Using pop with a default value helps avoid errors if the key is missing.

Using del on a missing key causes a KeyError, so be careful.

Summary

Use pop(key) to remove and get the value of a key.

Use pop(key, default) to avoid errors if the key is missing.

Use del dict[key] to remove a key without returning its value.

Practice

1. What does the pop(key) method do when used on a Python dictionary?

easy

A. Removes the key and returns its value

B. Removes the key without returning its value

C. Returns the value without removing the key

D. Deletes the entire dictionary

Solution

1. Step 1: Understand the pop method

   The pop(key) method removes the specified key from the dictionary and returns its value.

2. Step 2: Compare with other methods

   Unlike del dict[key], pop returns the removed value.

3. Final Answer:

   Removes the key and returns its value -> Option A

4. Quick Check:

   pop(key) = remove key + return value [OK]

Hint: pop returns value and removes key from dict [OK]

Common Mistakes:

• Thinking pop only returns value without removal
• Confusing pop with del which doesn't return value
• Assuming pop deletes entire dictionary

2. Which of the following is the correct syntax to remove a key 'age' from dictionary person without returning its value?

easy

A. person.delete('age')

B. person.pop('age')

C. person.remove('age')

D. del person['age']

Solution

1. Step 1: Identify syntax for deletion without return

   To remove a key without returning its value, use del dict[key].

2. Step 2: Check options

   del person['age'] uses del person['age'], which is correct syntax. Options C and D are invalid methods.

3. Final Answer:

   del person['age'] -> Option D

4. Quick Check:

   del dict[key] removes key without return [OK]

Hint: Use del dict[key] to remove key without return [OK]

Common Mistakes:

• Using pop when no return is needed
• Using non-existent methods like remove or delete
• Wrong syntax like person.delete('age')

3. What is the output of this code?

data = {'a': 1, 'b': 2, 'c': 3}
value = data.pop('b')
print(value, data)

medium

A. 2 {'a': 1, 'b': 2, 'c': 3}

B. None {'a': 1, 'c': 3}

C. 2 {'a': 1, 'c': 3}

D. KeyError

Solution

1. Step 1: Use pop to remove key 'b'

   The pop('b') removes key 'b' and returns its value 2.

2. Step 2: Print returned value and updated dictionary

   After removal, dictionary is {'a': 1, 'c': 3}. Printing value and dict shows: 2 {'a': 1, 'c': 3}.

3. Final Answer:

   2 {'a': 1, 'c': 3} -> Option C

4. Quick Check:

   pop returns value and removes key [OK]

Hint: pop returns value and removes key from dict [OK]

Common Mistakes:

• Expecting original dict unchanged
• Thinking pop returns None
• Confusing pop with del which returns nothing

4. What error will this code produce?

info = {'name': 'Alice', 'age': 30}
info.pop('gender')

medium

A. None

B. KeyError

C. Returns 'gender'

D. SyntaxError

Solution

1. Step 1: Understand pop behavior without default

   Calling pop on a missing key without a default raises a KeyError.

2. Step 2: Check code

   Since 'gender' is not in info, info.pop('gender') raises KeyError.

3. Final Answer:

   KeyError -> Option B

4. Quick Check:

   pop missing key without default = KeyError [OK]

Hint: pop missing key without default causes KeyError [OK]

Common Mistakes:

• Expecting None instead of error
• Thinking pop returns the key name
• Confusing with pop(key, default)

5. Given items = {'apple': 5, 'banana': 0, 'cherry': 7}, which code removes all entries with value 0 or less safely without errors?

hard

A. for k in list(items):
if items[k] <= 0:
items.pop(k)

B. for k in items:
if items[k] <= 0:
del items[k]

C. items.pop('banana')

D. del items['banana']

Solution

1. Step 1: Avoid modifying dict while iterating

   Directly deleting keys while iterating causes runtime errors. Using list(items) copies keys safely.

2. Step 2: Use pop to remove keys with value ≤ 0

   Loop over copied keys, check value, and use pop to remove safely.

3. Final Answer:

   for k in list(items): if items[k] <= 0: items.pop(k) -> Option A

4. Quick Check:

   Iterate on list copy + pop keys safely [OK]

Hint: Iterate on list(items) to safely remove keys while looping [OK]

Common Mistakes:

• Deleting keys directly while iterating causes error
• Using pop without copying keys list
• Removing only one key instead of all matching