Als een lijst uit een rij genummerde vakken bestaat, is een Python-woordenboek een verzameling gelabelde vakken. Je vraagt ​​wat je wilt op naam in plaats van op positie. Daarom zitten woordenboeken achter JSON-gegevens, configuratie, caches en een groot deel van Python zelf.

Deze tutorial begint met de basis en gaat verder met de patronen die ervaren ontwikkelaars dagelijks gebruiken. We hebben alle voorbeelden uitgevoerd op Python 3.13 en de getoonde uitvoer is afkomstig van die run.

Wat is een woordenboek?

Een woordenboek, oftewel dict, wijst sleutels toe aan waarden. Elke sleutel verschijnt slechts één keer en waarden kunnen van alles zijn, inclusief lijsten of andere woordenboeken.

Sinds Python 3.7 behouden woordenboeken officieel de invoegvolgorde. Veel oudere tutorials noemen ze nog steeds ongeordend, wat niet langer waar is. Voor een bredere vergelijking van de andere typen, zie Python-lijst versus tupel versus set.

Opzoekingen zijn snel omdat woordenboeken een hashtabel gebruiken. Het controleren van een sleutel kost ongeveer evenveel tijd, ongeacht of het woordenboek tien of een miljoen items bevat, terwijl het doorzoeken van een lijst langzamer wordt naarmate deze groeit.

Maak een woordenboek

user = {"name": "Asha", "age": 31, "city": "Pune"}

empty = {}
from_keywords = dict(name="Asha", age=31)
from_pairs = dict([("a", 1), ("b", 2)])

Accolades zijn de meest voorkomende vorm. Eén valkuil: {} creëert een leeg woordenboek, geen lege verzameling. Voor een lege set heb je set() nodig.

Lees waarden veilig af

Er zijn twee manieren om een waarde te lezen, en het verschil is van belang als een sleutel mogelijk niet bestaat:

user["name"]                  # 'Asha'
user["email"]                 # KeyError: 'email'

user.get("email")             # None
user.get("email", "not set")  # 'not set'

Gebruik vierkante haken als de sleutel moet bestaan, zodat een ontbrekende sleutel luid faalt. Gebruik get() als afwezigheid normaal is, zoals een optioneel veld in een API-antwoord. Om te controleren of er een sleutel is, gebruikt u de operator in, die naar sleutels kijkt in plaats van naar waarden:

"city" in user    # True
"Pune" in user    # False

Toevoegen, bijwerken en verwijderen

Als u een sleutel aan een sleutel toekent, wordt deze bijgewerkt als deze bestaat, of wordt deze toegevoegd als deze niet bestaat:

user["age"] = 32
user["email"] = "asha@example.com"
print(user)

# {'name': 'Asha', 'age': 32, 'city': 'Pune', 'email': 'asha@example.com'}

Python biedt verschillende manieren om items te verwijderen:

user.pop("city")          # returns 'Pune' and removes it
user.pop("phone", None)   # no error if it is missing
del user["email"]         # removes it, and raises KeyError if missing
user.clear()              # empties the dictionary

Gebruik pop() als u de waarde terug wilt. Door een standaardwaarde als tweede argument door te geven, wordt een fout vermeden als de sleutel er niet is. popitem() verwijdert het meest recent toegevoegde paar en retourneert het.

Loop over een woordenboek

Looping geeft je direct de sleutels. Gebruik items() om zowel sleutels als waarden op te halen:

user = {"name": "Asha", "age": 32}

for key, value in user.items():
    print(key, "=", value)

# name = Asha
# age = 32

keys(), values() en items() geven liveweergaven weer in plaats van kopieën, zodat ze latere wijzigingen weerspiegelen. Voeg geen sleutels toe of verwijder deze niet tijdens het doorlopen van een woordenboek, omdat Python een RuntimeError opwerpt. Loop over list(user) als dat nodig is.

Spiekbriefje voor woordenboekmethoden

Woordenboeken samenvoegen

Een algemene behoefte is het toepassen van gebruikersinstellingen bovenop de standaardinstellingen. Als de toetsen botsen, wint de rechterkant:

defaults = {"theme": "light", "lang": "en"}
saved = {"theme": "dark"}

defaults | saved
{**defaults, **saved}

# Both give: {'theme': 'dark', 'lang': 'en'}

De operator | heeft Python 3.9 of hoger nodig, terwijl de versie ** ook op oudere versies werkt. Beiden maken een nieuw woordenboek aan. Daarentegen veranderen defaults.update(saved) en defaults |= saved defaults van plaats.

Begrijpen en sorteren

Woordenboekbegrippen bouwen een nieuw woordenboek op in één leesbare regel, net zoals lijstbegrippen dat doen voor lijsten:

prices = {"pen": 10, "book": 250, "bag": 900}

{k: v for k, v in prices.items() if v > 100}
# {'book': 250, 'bag': 900}

Om op waarde te sorteren, geeft u een functie key door aan sorted(). Gebruik max() om de sleutel met de grootste waarde te vinden:

sorted(prices.items(), key=lambda item: item[1], reverse=True)
# [('bag', 900), ('book', 250), ('pen', 10)]

max(prices, key=prices.get)
# 'bag'

Een woordenboek heeft geen sort()-methode en sorted() retourneert een lijst met paren. Plaats het resultaat in dict() als je een woordenboek in die volgorde wilt.

Patronen tellen en groeperen

Er komen voortdurend twee taken naar voren. De eerste is tellen, wat je kunt doen met get(), standaard ingesteld op nul:

words = "to be or not to be".split()

counts = {}
for word in words:
    counts[word] = counts.get(word, 0) + 1

print(counts)
# {'to': 2, 'be': 2, 'or': 1, 'not': 1}

De standaardbibliotheek maakt dit nog korter met Counter:

from collections import Counter

Counter(words).most_common(2)
# [('to', 2), ('be', 2)]

De tweede is groeperen, en defaultdict is hier ideaal omdat het de ontbrekende waarde voor u creëert:

from collections import defaultdict

orders = [("Asha", 1200), ("Ben", 300), ("Asha", 800)]

by_customer = defaultdict(list)
for name, total in orders:
    by_customer[name].append(total)

print(dict(by_customer))
# {'Asha': [1200, 800], 'Ben': [300]}

Zonder dit zou u moeten controleren of elke sleutel bestaat voordat u deze toevoegt. Deze zelfde patronen werken goed voor het aggregeren van API-gegevens of logregels. Wanneer een woordenboek leeg is of een sleutel ontbreekt, laat onze gids voor Python-uitzonderingsafhandeling zien hoe u met de resulterende problemen omgaat KeyError.

Geneste gegevens en de kopieerval

JSON verwijst rechtstreeks naar geneste woordenboeken en lijsten, zodat u vaak sleutels aan elkaar moet koppelen. Chaining get() houdt dit veilig als er een niveau ontbreekt:

response = {"user": {"profile": {"city": "Pune"}}}

response["user"]["profile"]["city"]               # 'Pune'
response.get("user", {}).get("settings", {}).get("theme")   # None

Wees voorzichtig bij het kopiëren van geneste gegevens. copy() dupliceert alleen het hoogste niveau, zodat de interne woordenboeken gedeeld blijven met het origineel:

settings = {"db": {"host": "localhost"}}

shallow = settings.copy()
shallow["db"]["host"] = "prod"

print(settings["db"]["host"])
# prod

Als u de kopie wijzigt, wordt het origineel gewijzigd, wat een vervelende bug kan zijn. Gebruik copy.deepcopy(settings) om een ​​volledig onafhankelijke kopie te krijgen.

Wat kan een woordenboeksleutel zijn?

Sleutels moeten hashbaar zijn, wat over het algemeen onveranderlijk betekent. Tekenreeksen, getallen en tupels van onveranderlijke waarden werken allemaal. Lijsten en woordenboeken doen niet:

{["a"]: 1}

# TypeError: unhashable type: 'list'

De reden is dat de hash van een sleutel bepaalt waar de waarde ervan wordt opgeslagen. Als een sleutel zou kunnen veranderen, zou Python deze niet langer kunnen vinden. Als je een samengestelde sleutel nodig hebt, gebruik dan een tuple, zoals {("Pune", 2026): 120}.

Veel voorkomende fouten

• Gebruik vierkante haakjes op optionele sleutels. Reik naar get() als een sleutel mogelijk ontbreekt.
• Ervan uitgaande dat get() betekent dat de sleutel bestaat. None kan betekenen dat de sleutel ontbreekt, of dat er een opgeslagen None is. Gebruik in als het verschil ertoe doet.
• Met behulp van een veranderlijke standaard. dict.fromkeys(names, []) krijgt elke sleutel precies dezelfde lijst. Gebruik in plaats daarvan een begrip.
• Grootte wijzigen tijdens iteratie. Loop over een kopie van de sleutels.
• Een dictaat gebruiken voor vaste, bekende velden. Een dataclass kan duidelijker zijn en vangt typefouten op in veldnamen.

Tot slot

Woordenboeken belonen een beetje oefening. Onthoud get() voor optionele toetsen, items() voor loops, en Counter en defaultdict voor de twee meest voorkomende taken. Om te oefenen, neemt u een klein JSON-bestand en schrijft u code om de records ervan te tellen en te groeperen. Als je nieuw bent in de taal, begin dan met onze Python-tutorial voor beginners.

Veelgestelde vragen

Blijf leren