Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

collections.defaultdict

Cria um dicionário útil para agrupar valores por chave.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

collections.defaultdict(list)

Cria um dicionário útil para agrupar valores por chave.

A chave ausente passa por __missing__, que get não chama. Uma exceção da fábrica como ValueError propaga-se sem criar a entrada. Se faltar uma chave ao ler com parênteses retos, chama default_factory sem argumentos, guarda o resultado nessa chave e devolve-o. Quando a fábrica é None, esse acesso gera KeyError.

No exemplo get deixa o dicionário vazio e groups["a"] cria a lista que recebe 8.

from collections import defaultdict
d = defaultdict(list)
assert d.get("x") is None and "x" not in d
assert d["x"] is d["x"] and d["x"] is not d["y"]
d.default_factory = None
try:
    d["z"]
except KeyError:
    assert "z" not in d
else:
    raise AssertionError
def fail():
    raise ValueError("no group")
d = defaultdict(fail)
assert d.get("new") is None
try:
    d["new"]
except ValueError:
    assert "new" not in d
else:
    raise AssertionError

Exemplos

import collections
groups = collections.defaultdict(list)
print(groups.get("a"), len(groups))
groups["a"].append(8)
print(dict(groups))

Resultado

None 0
{'a': [8]}

No exemplo get deixa o dicionário vazio e groups["a"] cria a lista que recebe 8.

Fontes