Dictionaries & Key-Value Storage

The Dictionary

If Lists are the most flexible structure, Dictionaries are the most powerful. A dictionary stores data in Key-Value pairs. They are highly optimized for retrieving data instantly, regardless of how massive the dictionary gets.

player = {
    "username": "DragonSlayer99",
    "level": 42,
    "is_online": True
}

Safe Retrieval with get()

Normally, you access a value via its key: player["level"]. However, if the key doesn't exist, your program will crash with a KeyError. The professional way to retrieve data is using the get() method, which returns None (or a default value) instead of crashing.

# Returns 'No Clan' instead of crashing if 'clan' doesn't exist
clan = player.get("clan", "No Clan")

Iterating Through Dictionaries

When looping through a dictionary, you can extract the keys, the values, or both simultaneously using .items().

for key, value in player.items():
    print(f"{key.capitalize()}: {value}")

Nesting Data

Dictionaries can hold lists, tuples, or even other dictionaries, making them perfect for structuring complex data like JSON responses from APIs.