Dicionários¶

Dicionário é uma coleção de itens (chamados chaves) e seus respectivos significados (chamados de valores):

{chave: valor}

Cada chave do dicionário deve ser única! Ao contrário de listas, dicionários, não podem ter chaves repetidas.

Nota

As chaves devem ser únicas.

Declaração¶

Declaramos um dicionário colocando entre chaves {} cada chave e o seu respectivo valor, da seguinte forma:

>>> telefones = {"ana": 123456, "yudi": 40028922, "julia": 4124492}
>>> telefones
{'ana': 123456, 'yudi': 40028922, 'julia': 4124492}

No caso acima, a chave "ana", por exemplo, está relacionada ao valor 123456. Cada par chave-valor é separado por uma vírgula , .

Função `dict()`¶

A função dict() constrói um dicionário. Existem algumas formas de usá-la:

Com uma lista de listas:

>>> lista1 = ["brigadeiro", "leite condensado, achocolatado"]
>>> lista2 = ["omelete", "ovos, azeite, condimentos a gosto"]
>>> lista3 = ["ovo frito", "ovo, óleo, condimentos a gosto"]
>>> lista_receitas = [lista1, lista2, lista3]
>>> print(lista_receitas)
[['brigadeiro', 'leite condensado, achocolatado'], ['omelete', 'ovos, azeite, condimentos a gosto'], ['ovo frito', 'ovo, óleo, condimentos a gosto']]
>>> receitas = dict(lista_receitas)
>>> print(receitas)
{'brigadeiro': 'leite condensado, achocolatado', 'omelete': 'ovos, azeite, condimentos a gosto', 'ovo frito': 'ovo, óleo, condimentos a gosto'}

Atribuindo os valores diretamente:
```
>>> constantes = dict(pi=3.14, e=2.7, alpha=1/137)
>>> print(constantes)
{'pi': 3.14, 'e': 2.7, 'alpha': 0.0072992700729927005}
```
Neste caso, o nome das chaves deve ser um identificador válido. As mesmas regras de nomes de variáveis se aplicam.

Usando as chaves {}:

>>> numerinhos = dict({"um": 1, "dois": 2, "três": 3})
>>> print(numerinhos)
{'um': 1, 'dois': 2, 'três': 3}

E nesse caso se não houvesse a função dict(), o resultado seria exatamente o mesmo…

Chaves¶

Acessamos um determinado valor do dicionário através de sua chave:

>>> capitais = {"SP": "São Paulo", "AC": "Rio Branco", "TO": "Palmas", "RJ": "Rio de Janeiro", "SE": "Aracaju", "MG": "Belo Horizonte"}
>>> capitais["MG"]
'Belo Horizonte'

Até o momento, usamos apenas strings, mas podemos colocar todo tipo de coisa dentro dos dicionários, incluindo listas e até mesmo outros dicionários:

>>> numeros = {"primos": [2, 3, 5], "pares": [0, 2, 4], "ímpares": [1, 3, 5]}
>>> numeros["ímpares"]
[1, 3, 5]

Mesmo que os pares chave-valor estejam organizados na ordem que foram colocados, não podemos acessá-los por índices como faríamos em listas:

>>> numeros[2]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: 2

O mesmo erro ocorre se tentarmos colocar uma chave que não pertence ao dicionário:

>>> numeros["negativos"]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: 'negativos'

Assim como os valores não precisam ser do tipo string, o mesmo vale para as chaves:

>>> numeros_por_extenso = {2: "dois", 1: "um", 3: "três", 0: "zero"}
>>> numeros_por_extenso[0]
'zero'
>>> numeros_por_extenso[2]
'dois'

Nota

Listas e outros dicionários não podem ser usados como chaves por serem de tipos mutáveis.

Adicionando e removendo elementos¶

Podemos alterar o valor relacionado a uma chave da seguinte forma:

>>> pessoa = {"nome": "Cleiton", "idade": 34, "família": {"mãe": "Maria", "pai": "Enzo"}}
>>> pessoa["idade"]
34
>>> pessoa["idade"] = 35
>>> pessoa["idade"]
35

Para adicionar um elemento novo à um dicionário, podemos simplesmente fazer o seguinte:

>>> meses = {1: "Janeiro", 2: "Fevereiro", 3: "Março"}
>>> meses[4] = "Abril"
>>> meses
{1: "Janeiro", 2: "Fevereiro", 3: "Março", 4: "Abril"}

Aqui nos referimos a uma chave que não está no dicionário e associamos um valor a ela. Desta forma, adicionando esse conjunto chave-valor ao dicionário.

Removemos um conjunto chave-elemento de um dicionário com o comando del:

>>> meses
{1: "Janeiro", 2: "Fevereiro", 3: "Março", 4: "Abril"}
>>> del(meses[4])
>>> meses
{1: "Janeiro", 2: "Fevereiro", 3: "Março"}

Para apagar todos os elementos de um dicionário, usamos o método clear:

>>> lixo = {"plástico": ["garrafa", "copinho", "canudo"], "papel": ["folha amassada", "guardanapo"], "orgânico": ["batata", "resto do bandeco", "casca de banana"]}
>>> lixo
{"plástico": ["garrafa", "copinho", "canudo"], "papel": ["folha amassada", "guardanapo"], "organico": ["batata", "resto do bandeco", "casca de banana"]}
>>> lixo.clear()
>>> lixo
{}

Unindo Dicionários¶

Para versões anteriores a 3.9 do Python, use o método .update() para colocar o conteúdo de um segundo dicionário no original:

>>> comodos1 = {'casa': 1, 'quartos': 2, 'banheiros': 2}
>>> comodos2 = {'cozinha': 1, 'quintal': 1}
>>> comodos1.update(comodos2)
>>> print(comodos1)
{'casa': 1, 'quartos': 2, 'banheiros': 2, 'cozinha': 1, 'quintal': 1}

A partir da versão 3.9 do Python, é possível unificar dois dicionários com o operador | (barra vertical ou pipe – em inglês):

>>> comodos1 = {'casa': 1, 'quartos': 2, 'banheiros': 2}
>>> comodos2 = {'cozinha': 1, 'quintal': 1}
>>> casa = comodos1 | comodos2
>>> print(casa)
{'casa': 1, 'quartos': 2, 'banheiros': 2, 'cozinha': 1, 'quintal': 1}
>>> print(comodos1)
{'casa': 1, 'quartos': 2, 'banheiros': 2}

Note que o .update altera o comodos1 sem retornar nada enquanto o | retorna e cria um novo array sem alterar o comodos1.

Função `list()`¶

A função list() recebe um conjunto de objetos e retorna uma lista. Ao passar um dicionário, ela retorna uma lista contendo todas as suas chaves:

>>> institutos_uspsc = {"IFSC": "Instituto de Física de São Carlos", "ICMC": "Instituto de Ciências Matemáticas e de Computação", "EESC": "Escola de Engenharia de São Carlos", "IAU": "Instituto de Arquitetura e Urbanismo", "IQSC": "Instituto de Química de São Carlos"}
>>> list(institutos_uspsc)
['IQSC', 'IFSC', 'ICMC', 'IAU', 'EESC']

Função `len()`¶

A função len() retorna o número de elementos («tamanho») do objeto passado para ela. No caso de uma lista, fala quantos elementos há. No caso de dicionários, retorna o número de chaves contidas nele:

>>> institutos_uspsc
{'IQSC': 'Instituto de Química de São Carlos', 'IFSC': 'Instituto de Física de São Carlos', 'ICMC': 'Instituto de Ciências Matemáticas e de Computação', 'IAU': 'Instituto de Arquitetura e Urbanismo', 'EESC': 'Escola de Engenharia de São Carlos'}
>>> len(institutos_uspsc)
5

Você pode contar o número de elementos na lista gerada pela função list() para conferir:

>>> len(list(institutos_uspsc))
5

Método `get()`¶

O método get(chave, valor) pode ser usado para retornar o valor associado à respectiva chave! O segundo parâmetro <valor> é opcional e indica o que será retornado caso a chave desejada não esteja no dicionário:

>>> institutos_uspsc.get("IFSC")
'Instituto de Física de São Carlos'

Dá para ver que ele é muito parecido com fazer assim:

>>> institutos_uspsc["IFSC"]
'Instituto de Física de São Carlos'

Mas ao colocarmos uma chave que não está no dicionário:

>>> institutos_uspsc.get("Poli", "Não tem!")
'Não tem!'
>>> institutos_uspsc["Poli"]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: 'Poli'

Alguns métodos¶

O método items() pode ser comparado com o inverso da função dict():

>>> pessoa = {"nome": "Enzo", "RA": 242334, "curso": "fiscomp"}
>>> pessoa.items()
dict_items([('curso', 'fiscomp'), ('nome', 'Enzo'), ('RA', 242334)])

Usando a função list() nesse resultado, obtemos:

  >>> pessoa.items()
  dict_items([('curso', 'fiscomp'), ('nome', 'Enzo'), ('RA', 242334)])
  >>> itens = list(pessoa.items())
  >>> itens
  [('curso', 'fiscomp'), ('nome', 'Enzo'), ('RA', 242334)]

Experimente usar a função ``dict()`` na lista ``itens``!

O método values() nos retorna os valores do dicionário:

>>> pessoa.values()
dict_values(['fiscomp', 'Enzo', 242334])
>>> valores = list(pessoa.values())
>>> valores
['fiscomp', 'Enzo', 242334]

O método keys() nos retorna as chaves do dicionário:

>>> pessoa.keys()
dict_keys(['curso', 'nome', 'RA'])
>>> chaves = list(pessoa.keys())
>>> chaves
['curso', 'nome', 'RA']

Repare que nesse último obtemos o mesmo que se tivéssemos usado a função list():

>>> list(pessoa)
['curso', 'nome', 'RA']

Ordem dos elementos¶

Dicionários não tem sequência dos seus elementos. As listas têm. Dicionários mapeiam um valor a uma chave. Veja este exemplo:

>>> numerinhos = dict({"um": 1, "dois": 2, "três": 3})
>>> numeritos = {"três": 3, "dois": 2, "um": 1}
>>> numerinhos == numeritos
True
>>> numeritos
{'três': 3, 'dois': 2, 'um': 1}
>>> numerinhos
{'um': 1, 'dois': 2, 'três': 3}

Vemos que numerinhos e numeritos têm as mesmas chaves com os mesmos valores e por isso são iguais. Mas quando imprimimos cada um, a ordem que aparece é a que os itens foram inseridos.

Nota

A partir da versão 3.7 do Python, a ordem das chaves no dicionário é garantida como sendo a ordem de inserção.

Está no dicionário?¶

Podemos checar se uma chave está ou não em um dicionário utilizando o comando in. Voltando para o dicionário que contem os institutos da USP São Carlos:

>>> institutos_uspsc
{'IQSC': 'Instituto de Química de São Carlos', 'IFSC': 'Instituto de Física de São Carlos', 'ICMC': 'Instituto de Ciências Matemáticas e de Computação', 'IAU': 'Instituto de Arquitetura e Urbanismo', 'EESC': 'Escola de Engenharia de São Carlos'}
>>> "IFSC" in institutos_uspsc
True
>>> "ESALQ" in institutos_uspsc
False

E checamos se uma chave não está no dicionário com o comando not in:

>>> institutos_uspsc
{'IQSC': 'Instituto de Química de São Carlos', 'IFSC': 'Instituto de Física de São Carlos', 'ICMC': 'Instituto de Ciências Matemáticas e de Computação', 'IAU': 'Instituto de Arquitetura e Urbanismo', 'EESC': 'Escola de Engenharia de São Carlos'}
>>> "IFSC" not in institutos_uspsc
False
>>> "ESALQ" not in institutos_uspsc
True

Remove e Retorna pares chave/valor¶

Com o método popitem() é possível remover, de forma arbitrária, itens de um dicionário e retorna-o na forma de um par chave/valor. Este método pode ser útil para algoritmos que utilizam dicionários como uma lista de atividades. Por exemplo, uma relação de clientes para realizar ligações:

>>> clientes_para_ligar = {
     "Ateneu": 55449090,
     "Bielzinho": 54549090,
     "Charlinho": 44559090,
     "Deividy": 45459090}

>>> clientes_para_ligar.popitem()
('Deividy', 45459090)

>>> clientes_para_ligar
{'Ateneu': 55449090, 'Bielzinho': 54549090, 'Charlinho': 44559090}  # Repare que o Deividy saiu do dicionário

>>> clientes_para_ligar.popitem()
('Bielzinho', 54549090)

>>> clientes_para_ligar.popitem()
('Charlinho', 44559090)

>>> clientes_para_ligar.popitem()
('Ateneu', 55449090)

>>> clientes_para_ligar.popitem()
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: 'popitem(): dictionary is empty'

>>> clientes_para_ligar
{}

Esta última chamada do popitem() retorna um erro, pois o dicionário está vazio.

Exercícios¶

Faça um dicionário com as 5 pessoas mais perto de você, tendo o nome como chave e a cor da camisa que está usando como valor.
Crie um dicionário vazio semana = {} e o complete com uma chave para cada dia da semana, tendo como seu valor uma lista com as aulas que você tem nesse dia (sábado e domingo recebem listas vazias, ou você tem aula?).
Crie um dicionário vazio filmes = {}. Utilize o nome de um filme como chave. E, como valor, outro dicionário contendo o vilão e o ano em que o filme foi lançado. Preencha 5 filmes.

Sumário¶

Operação	Descrição
`telefones = {"Ana": 123456, "yudi": 654321}`	Cria um dicionário com duas chaves, usando `{}`
`telefones = dict(Ana=123456, yudi=654321)`	Cria um dicionário com duas chaves, usando o método `dict()`
`telefones = dict((("Ana", 123456), ("yudi", 654321)))`	Cria um dicionário com duas chaves a partir de uma lista de tuplas
`telefones["Ana"] # Retorna 123456`	Acessa o valor do telefone da chave «Ana»
`telefone["thiago"] = 9876543`	Adiciona mais um telefone na lista
`del telefone["thiago"]`	Remove um telefone do dicionário
`telefone.clear()`	Remove todos os elementos de um dicionário
`dict1.update(dict2)`	Para versões anteriores a 3.9 do Python, use o método `.update()` para colocar o conteúdo de um segundo dicionário no original
`dict1 \| dict2`	A partir da versão 3.9 do Python, é possível unificar dois dicionários com o operador `\|` (barra vertical ou pipe – em inglês)
`list(telefones) # Retorna ["Ana", "yudi"]`	Obtém as chaves de um dicionário
`telefones.keys() # Retorna ("Ana", "yudi")`	Obtém as chaves de um dicionário
`len(telefones)`	Retorna a quantidade de chaves no dicionário
`telefones.get("João", "N/A")`	Retorna o valor associado à chave `João` ou `N/A` caso a chave não exista.
`telefones.items()`	Retorna uma lista de tuplas contendo a chave e o valor de cada item do dicionário
`telefones.values()`	Retorna uma lista com apenas os valores dos dicionários
`"Ana" in telefones`	Verifica se a chave «Ana» existe no dicionário
`telefones.popitem()`	Remove e retorna a última chave do dicionário

Dicionários¶

Declaração¶

Função dict()¶

Chaves¶

Adicionando e removendo elementos¶

Unindo Dicionários¶

Função list()¶

Função len()¶

Método get()¶

Alguns métodos¶

Ordem dos elementos¶

Está no dicionário?¶

Remove e Retorna pares chave/valor¶

Exercícios¶

Sumário¶

Função `dict()`¶

Função `list()`¶

Função `len()`¶

Método `get()`¶