Dicionários Python: Adicionando, Atualizando e Gerenciando Pares Chave/Valor

Dicionários Python são estruturas de dados fundamentais que armazenam dados como pares chave/valor. Chaves são imutáveis e únicas, enquanto valores podem ser qualquer tipo de dado, incluindo estruturas aninhadas.

Regras-Chave para Chaves de Dicionário

• Chaves duplicadas são sobrescritas: a última ocorrência tem precedência.
• Tipos de chave permitidos incluem strings, números, tuplas e outros objetos hashable. Tipos mutáveis como listas não podem ser usados como chaves.
• Funções built-in do Python, classes e até funções em si podem servir como chaves.

Adicionando Elementos a um Dicionário

Para adicionar um novo par chave/valor, simplesmente atribua um valor a uma nova chave:

my_dict = {"username": "XYZ", "email": "xyz@example.com"}
my_dict["location"] = "Mumbai"
print(my_dict)

Saída: {"username": "XYZ", "email": "xyz@example.com", "location": "Mumbai"}

Quando o valor é uma lista, você pode anexar itens a essa lista:

my_dict = {"tags": []}
my_dict["tags"].append("python")
print(my_dict)

Saída: {"tags": ["python"]}

Acessando Elementos do Dicionário

Recupere um valor por sua chave usando colchetes. Se a chave não existe, um KeyError é levantado:

print(my_dict["username"]) # XYZ
print(my_dict["nonexistent"]) # KeyError

Para evitar erros, use dict.get() ou dict.setdefault():

print(my_dict.get("nonexistent", "default"))

Deletando Elementos

• del keyword: del my_dict["username"]
• pop() method: removed = my_dict.pop("email") retorna o valor removido.
• clear() method: my_dict.clear() esvazia o dicionário.

Atualizando Valores Existentes

Atribua um novo valor a uma chave existente para atualizá-la:

my_dict["username"] = "ABC"
print(my_dict)

Combinando Dicionários

Mescle dois dicionários usando update() ou o operador de união (|) no Python 3.9+:

dict_a = {"a": 1, "b": 2}
dict_b = {"b": 3, "c": 4}
dict_a.update(dict_b)
print(dict_a) # {"a": 1, "b": 3, "c": 4}
# ou
combined = dict_a | dict_b
print(combined)

Incorporando um Dicionário Dentro de Outro

Atribua um dicionário inteiro a uma nova chave para aninhá-lo:

parent = {"username": "XYZ"}
child = {"firstName": "Nick", "lastName": "Price"}
parent["name"] = child
print(parent)

Saída: {"username": "XYZ", "name": {"firstName": "Nick", "lastName": "Price"}}

Resumo

• Chaves de dicionário são únicas, hashable e imutáveis.
• Use atribuição para adicionar ou atualizar, del ou pop() para remoção, e clear() para esvaziar.
• Métodos como update() e o operador de união simplificam mesclagem de dicionários.

Para mais detalhes, consulte a documentação oficial do Python: Python Data Structures – Dictionaries.