Um di­ci­o­ná­rio em Python é um tipo de dado im­por­tante dessa linguagem de pro­gra­ma­ção web. Ele é usado para associar termos e sig­ni­fi­ca­dos em pares de chave-valor. Estes, por sua vez, criam tabelas, coleções de dados e in­ven­tá­rios. Di­ci­o­ná­rio Python também podem ser usados em conjunto com Python loops for, condições Python if else e Python loops while.

O que é di­ci­o­ná­rio Python?

Di­ci­o­ná­rios Python são um tipo de dado que associa termos a sig­ni­fi­ca­dos. A estrutura permite que chaves e valores sejam as­so­ci­a­dos, ar­ma­ze­na­dos e re­cu­pe­ra­dos pos­te­ri­or­mente. Se­me­lhante a um di­ci­o­ná­rio regular, no qual um termo é associado a uma ex­pli­ca­ção ou tradução, um di­ci­o­ná­rio Python cria uma tabela de as­so­ci­a­ção que não aceita du­pli­ca­tas. Isso significa que cada chave aparece apenas uma vez.

Estrutura do di­ci­o­ná­rio Python

Um di­ci­o­ná­rio Python sempre é de­li­mi­tado por chaves ({}). A chave e o valor cor­res­pon­dente são co­nec­ta­dos por dois pontos (:), e os pares re­sul­tan­tes são separados por vírgulas. Te­o­ri­ca­mente, um di­ci­o­ná­rio Python pode conter qualquer número de pares de chave-valor. A chave deve ser colocada entre aspas. Você pro­va­vel­mente sabe como fazer isso, se já acessou o nosso tutorial de Python. Veja o exemplo abaixo:

idades = {'Jim': 42, 'Jack': 13, 'John': 69}
python

O di­ci­o­ná­rio pode ser acessado se co­lo­car­mos a chave correta entre colchetes ([]). Veja como aplicamos isso ao código:

idade_jim = idades['Jim']
assert idade_jim == 42
python

Exemplo de di­ci­o­ná­rio Python

Estrutura e fun­ci­o­na­li­dade de um di­ci­o­ná­rio Python podem ser ex­pli­ca­das com a ajuda de um exemplo simples. Atri­buí­mos capitais a países e os exibimos em uma estrutura. O di­ci­o­ná­rio deve se parecer com isto:

capitais = { "UK": "Londres", "FR": "Paris", "DE": "Berlim" }
python

Use colchetes para consultar um elemento es­pe­cí­fico:

capitais["FR"]
assert capitais["FR"] == 'Paris'
python

A saída seria o valor associado à chave “FR” (França), que é “Paris”.

Estrutura al­ter­na­tiva

Você também pode criar um di­ci­o­ná­rio Python sem conteúdo e preenchê-lo pos­te­ri­or­mente. Primeiro, crie um di­ci­o­ná­rio vazio, que deve ter a seguinte aparência:

capitais = { }
python

Complete o di­ci­o­ná­rio pos­te­ri­or­mente:

capitais["UK"] = "Londres"
capitais["FR"] = "Paris"
capitais["DE"] = "Berlim"
python

Ao consultar o di­ci­o­ná­rio “capitais”, a saída será a seguinte:

{ "UK": "Londres", "FR": "Paris", "DE": "Berlim" }
python

Alterar di­ci­o­ná­rio Python

Você também pode modificar o seu di­ci­o­ná­rio do Python em momento posterior. Basta usar o código abaixo para adicionar pares de chave-valor:

capitais["IT"] = "Roma"
print(capitais)
python

Agora, o seu di­ci­o­ná­rio terá esta aparência:

{ "UK": "Londres", "FR": "Paris", "DE": "Berlim", "IT": "Roma" }
python

Use o seguinte código para alterar o valor de um par chave-valor:

capitais = { "UK": "Londres", "FR": "Paris", "DE": "Berlim", "IT": "???" }
assert capitais["IT"] == "???"
capitais["IT"] = "Roma"
assert capitais["IT"] == "Roma"
python

A saída será:

{ "UK": "Londres", "FR": "Paris", "DE": "Berlim", "IT": "Roma" }
python

Remover pares chave-valor do di­ci­o­ná­rio Python

Existem três opções para remover pares de chave-valor de um di­ci­o­ná­rio Python: del, pop e popitem.

Remoção com del

Um in­ven­tá­rio simples é um bom exemplo para apli­car­mos o método del. Suponha que uma padaria ofereça 100 pães, 25 bolos e 20 crois­sants ao abrir. O di­ci­o­ná­rio cor­res­pon­dente seria:

estoque = { "pães": 100, "bolos": 25, "croissants": 20 }
python

Se a padaria vender todos os crois­sants e quiser excluí-los do estoque, o comando del pode ser usado:

del estoque["croissants"]
print(estoque)
python

Cer­ti­fi­que-se de sempre usar o comando del em conjunto com um par chave-valor. Caso contrário, o di­ci­o­ná­rio inteiro será excluído. Esse é um problema re­cor­rente no Python.

Remoção com pop

A segunda forma de remover pares chave-valor é com o método pop. Ele armazena o valor removido em uma nova variável:

bolinhas = { "vermelhas": 13, "verdes": 19, "azuis": 7, "amarelas": 21 }
vermelhas = bolinhas.pop("vermelhas")
print(f"Removemos {vermelhas} bolinhas vermelhas.")
print(f"Bolinhas restantes: {bolinhas}")
python

A saída será:

Removemos 13 bolinhas vermelhas.
Bolinhas restantes: {'verdes': 19, 'azuis': 7, 'amarelas': 21}
python

Remoção com popitem

Use o método popitem para remover o último par chave-valor do seu di­ci­o­ná­rio. Este é o código a ser usado:

ultimo = bolinhas.popitem()
print(ultimo)
print(bolinhas)
python

A saída será:

('amarelas', 21)
{ "verde": 19, "azul": 7 }
python

Outros métodos para di­ci­o­ná­rio Python

Abaixo estão listados outros métodos im­por­tan­tes que podem ser aplicados a di­ci­o­ná­rios Python:

Método Descrição
clear Remove todos os pares chave-valor.
copy Cria uma cópia do di­ci­o­ná­rio.
get Obtém o valor ao inserir a chave.
keys Retorna todas as chaves do di­ci­o­ná­rio.
update Adiciona elementos ao di­ci­o­ná­rio; chaves du­pli­ca­das são so­bres­cri­tas.
values Retorna todos os valores do di­ci­o­ná­rio.
Ir para o menu principal