Criar, ler, atualizar e remover pares

As quatro operações do cadastro

Um dicionário raramente nasce pronto e fica parado; ele muda conforme os dados mudam. Pense num estoque de loja: chega um produto novo (adicionar), você consulta o preço de um item (ler), um preço reajusta (atualizar), um produto sai de linha (remover). Essas quatro operações, tão comuns que ganharam um apelido em inglês, CRUD, de criar, ler, atualizar e apagar, são a espinha dorsal de quase todo sistema que guarda dados. No dicionário elas são diretas, e uma delas guarda uma sutileza esperta: adicionar e atualizar se escrevem do mesmo jeito, porque guardar numa chave nova cria o par e guardar numa chave existente substitui o valor.

estoque <- { "arroz": 10, "feijao": 8 }
// adicionar (chave nova):
estoque["cafe"] <- 5
// atualizar (chave que já existe): substitui o 10
estoque["arroz"] <- 12
// ler:
escreva(estoque["feijao"])   // 8
// remover:
remova(estoque["feijao"])
// agora o estoque tem arroz 12, cafe 5, e feijao não existe mais

Adicionar e atualizar usam a mesma escrita (chave recebe valor). A diferença é só se a chave já existia.

Checar antes de usar

O maior tropeço com dicionários é buscar ou remover uma chave que não existe. Consultar o telefone de um nome que não está na agenda, remover um produto já retirado, atualizar um cadastro apagado: cada um desses, dependendo da linguagem, dá erro ou devolve um vazio confuso. O antídoto é uma verificação simples e barata: antes de mexer numa chave incerta, pergunte se a chave existe no dicionário. É a mesma ideia da cláusula de guarda do módulo 2, aplicada a dicionários: trate o caso do ausente logo de cara, e o resto do código roda em segurança sabendo que a chave está lá. Essa checagem sozinha evita uma boa fatia dos bugs de quem começa com dicionários.

agenda <- { "Ana": "9991", "Beto": "9982" }
procurado <- "Caio"
se procurado existe em agenda então
  escreva(agenda[procurado])
senão
  escreva(procurado, " não está na agenda")
fim
// Caio não existe: mostra a mensagem em vez de dar erro

Checar a existência antes de acessar transforma um possível erro numa mensagem amigável.

Percorrer o dicionário inteiro

Às vezes você não quer uma chave específica, e sim visitar todos os pares: listar a agenda inteira, somar o estoque todo, imprimir cada preço. Para isso, dá para percorrer o dicionário com um laço, que a cada volta entrega um par de chave e valor. É a mesma ideia de percorrer uma lista, só que agora, em vez de um item, você recebe a dupla etiqueta e conteúdo. Com isso, somar o estoque inteiro é um acumulador que percorre os pares somando cada valor; listar a agenda é um laço que mostra cada nome com seu telefone. A busca direta pela chave e a varredura completa são as duas formas de trabalhar um dicionário, e você escolhe conforme precise de um valor ou de todos.