Como Adicionar Novas Chaves a um Dicionário em Python

Ao trabalhar com dicionários em Python, você pode se deparar com a necessidade de adicionar novas chaves e valores. Diferentemente de outras estruturas de dados, dicionários não possuem um método .add() ou .append(). Então, como você faz para adicionar novas entradas? Vamos explorar as maneiras simples, mas poderosas, de manipular dicionários em Python.

Curso Gratuito

Seu primeiro projeto Python – curso grátis com certificado!

Vá do zero ao primeiro projeto em apenas 2 horas com o curso Python para Iniciantes.

Comece agora

Adicionando uma Única Nova Chave a um Dicionário

Para adicionar um novo par chave-valor a um dicionário existente, você simplesmente atribui um valor a uma nova chave como se ela já existisse. Veja como fazer isso:

# Inicializa um dicionário
meu_dicionario = {'a': 1}
print(meu_dicionario)  # Saída: {'a': 1}

# Adiciona um novo par chave-valor
meu_dicionario['b'] = 2

print(meu_dicionario)  # Saída: {'a': 1, 'b': 2}

# Inicializa um dicionário
meu_dicionario = {'a': 1}
print(meu_dicionario)  # Saída: {'a': 1}

# Adiciona um novo par chave-valor
meu_dicionario['b'] = 2

print(meu_dicionario)  # Saída: {'a': 1, 'b': 2}

Se a chave que você está adicionando não existir, ela será criada e atribuída o valor que você fornecer. Se a chave já existir, seu valor será atualizado com o novo valor que você atribuir.

Adicionando Múltiplas Novas Chaves a um Dicionário

Se você precisa adicionar várias chaves de uma vez, o método dict.update() é seu aliado:

meu_dicionario = {'a': 1}
print(meu_dicionario)  # Saída: {'a': 1}

# Define um dicionário com novos pares chave-valor
novas_entradas = {'b': 2, 'c': 3, 'd': 4}

# Atualiza o dicionário original com as novas entradas
meu_dicionario.update(novas_entradas)
print(meu_dicionario)  # Saída: {'a': 1, 'b': 2, 'c': 3, 'd': 4}

meu_dicionario = {'a': 1}
print(meu_dicionario)  # Saída: {'a': 1}

# Define um dicionário com novos pares chave-valor
novas_entradas = {'b': 2, 'c': 3, 'd': 4}

# Atualiza o dicionário original com as novas entradas
meu_dicionario.update(novas_entradas)
print(meu_dicionario)  # Saída: {'a': 1, 'b': 2, 'c': 3, 'd': 4}

Para Python na versão 3.9 ou mais recente, você também pode usar o operador de atualização |=:

meu_dicionario = {'a': 1}

meu_dicionario |= {'b': 2, 'c': 3, 'd': 4}
print(meu_dicionario)  # Saída: {'a': 1, 'b': 2, 'c': 3, 'd': 4}

meu_dicionario = {'a': 1}

meu_dicionario |= {'b': 2, 'c': 3, 'd': 4}
print(meu_dicionario)  # Saída: {'a': 1, 'b': 2, 'c': 3, 'd': 4}

Mesclando Múltiplos Dicionários em um Único Dicionário

Para mesclar dicionários sem modificar os originais, você pode fazer o seguinte:

meu_dicionario = {'a': 1}

novo_dic_1 = {'b': 2, 'c': 3}
novo_dic_2 = {'d': 4}

meu_dicionario.update(novo_dic_1)
meu_dicionario.update(novo_dic_2)

print(meu_dicionario)  # Saída: {'a': 1, 'b': 2, 'c': 3, 'd': 4}

meu_dicionario = {'a': 1}

novo_dic_1 = {'b': 2, 'c': 3}
novo_dic_2 = {'d': 4}

meu_dicionario.update(novo_dic_1)
meu_dicionario.update(novo_dic_2)

print(meu_dicionario)  # Saída: {'a': 1, 'b': 2, 'c': 3, 'd': 4}

Para Python na versão 3.5 ou mais recente, a descompactação de dicionários está disponível:

meu_dicionario = {'a': 1}

novo_dic_1 = {'b': 2, 'c': 3}
novo_dic_2 = {'d': 4}

meu_dicionario = {**meu_dicionario, **novo_dic_1, **novo_dic_2}

meu_dicionario = {'a': 1}

novo_dic_1 = {'b': 2, 'c': 3}
novo_dic_2 = {'d': 4}

meu_dicionario = {**meu_dicionario, **novo_dic_1, **novo_dic_2}

E para Python na versão 3.9 ou mais recente, o operador de mesclagem | pode ser usado:

meu_dicionario = {'a': 1}

novo_dic_1 = {'b': 2, 'c': 3}
novo_dic_2 = {'d': 4}

meu_dicionario = meu_dicionario | novo_dic_1 | novo_dic_2

meu_dicionario = {'a': 1}

novo_dic_1 = {'b': 2, 'c': 3}
novo_dic_2 = {'d': 4}

meu_dicionario = meu_dicionario | novo_dic_1 | novo_dic_2

Resumo

Adicionar novas chaves a um dicionário em Python é direto. Você pode adicionar uma única chave simplesmente atribuindo um valor a ela, ou pode adicionar múltiplas chaves usando o método update() ou o operador de atualização |= em versões mais recentes do Python. Lembre-se, se uma chave já existir, seu valor será atualizado; caso contrário, um novo par chave-valor será adicionado. Com essas técnicas, você pode facilmente manipular dicionários para atender às suas necessidades de programação.

Se você quiser mais conteúdo de Python, leia nossos tutoriais sobre como iterar sobre dicionários em Python, e como usar uma compreensão de dicionários em Python. E se quiser aprender mais, acompanhe nosso Python MasterClass para aprender sobre Python em tempo recorde!