# Python Dictionary: Como usar dicionários em Python

Um dicionário em Python é um tipo de dado importante dessa linguagem de programação web. Ele é usado para associar termos e significados em pares de chave-valor. Estes, por sua vez, **criam tabelas, coleções de dados e inventários**. Dicionário Python também podem ser usados em conjunto com Python loops for, condições Python if else e Python loops while.

## O que é dicionário Python?

Dicionários Python são um tipo de dado que associa termos a significados. A estrutura permite que **chaves e valores** sejam associados, armazenados e recuperados posteriormente. Semelhante a um dicionário regular, no qual um termo é associado a uma explicação ou tradução, um dicionário Python cria uma tabela de associação que não aceita duplicatas. Isso significa que cada chave aparece apenas uma vez.

## Estrutura do dicionário Python

Um dicionário Python sempre é delimitado por chaves (`{}`). A chave e o valor correspondente são conectados por dois pontos (`:`), e os pares resultantes são separados por vírgulas. Teoricamente, um dicionário Python pode conter qualquer número de pares de chave-valor. A chave deve ser colocada entre aspas. Você provavelmente sabe como fazer isso, se já acessou o nosso [tutorial de Python](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/aprender-python/). Veja o exemplo abaixo:

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

O dicionário pode ser acessado se colocarmos a chave correta entre colchetes (`[]`). Veja como aplicamos isso ao código:

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

## Exemplo de dicionário Python

Estrutura e funcionalidade de um dicionário Python podem ser explicadas com a ajuda de um exemplo simples. Atribuímos capitais a países e os exibimos em uma estrutura. O dicionário deve se parecer com isto:

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

Use colchetes para consultar um elemento específico:

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

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

### Estrutura alternativa

Você também pode criar um dicionário Python sem conteúdo e preenchê-lo posteriormente. Primeiro, crie um dicionário vazio, que deve ter a seguinte aparência:

```python
capitais = { }
```

Complete o dicionário posteriormente:

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

Ao consultar o dicionário “capitais”, a saída será a seguinte:

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

## Alterar dicionário Python

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

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

Agora, o seu dicionário terá esta aparência:

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

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

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

A saída será:

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

## Remover pares chave-valor do dicionário Python

Existem três opções para remover pares de chave-valor de um dicionário Python: `del`, `pop` e `popitem`.

### Remoção com `del`

Um inventário simples é um bom exemplo para aplicarmos o método `del`. Suponha que uma padaria ofereça 100 pães, 25 bolos e 20 croissants ao abrir. O dicionário correspondente seria:

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

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

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

Certifique-se de sempre usar o comando `del` em conjunto com um par chave-valor. Caso contrário, o dicionário inteiro será excluído. Esse é um problema recorrente 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:

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

A saída será:

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

### Remoção com `popitem`

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

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

A saída será:

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

## Outros métodos para dicionário Python

Abaixo estão listados outros métodos importantes que podem ser aplicados a dicionários Python:

<table>
  <thead>
    <tr>
      <th>Método</th>
      <th>Descrição</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>`clear`</td>
      <td>Remove todos os pares chave-valor.</td>
    </tr>
    <tr>
      <td>`copy`</td>
      <td>Cria uma cópia do dicionário.</td>
    </tr>
    <tr>
      <td>`get`</td>
      <td>Obtém o valor ao inserir a chave.</td>
    </tr>
    <tr>
      <td>`keys`</td>
      <td>Retorna todas as chaves do dicionário.</td>
    </tr>
    <tr>
      <td>`update`</td>
      <td>Adiciona elementos ao dicionário; chaves duplicadas são sobrescritas.</td>
    </tr>
    <tr>
      <td>`values`</td>
      <td>Retorna todos os valores do dicionário.</td>
    </tr>
  </tbody>
</table>


This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/python-dictionary-dicionarios-python/](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/python-dictionary-dicionarios-python/) for AI/LLM consumption.