Módulo 6 - Dicionários: buscar pela etiqueta

O padrão da contagem de frequência

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 08/07/2026

O que você vai aprender

  • Entender a contagem de frequência: quantas vezes cada item aparece.
  • Usar o item como chave e a contagem como valor.
  • Tratar a primeira ocorrência (a chave que ainda não existe).
  • Reconhecer a contagem de frequência em problemas do dia a dia.

A chave é o item, o valor é a contagem

Existem perguntas que aparecem em todo canto: qual a palavra mais usada num texto? quantos votos cada candidato teve? quantas vezes cada produto foi vendido? quem mais mandou mensagem no grupo? Todas têm a mesma forma: contar quantas vezes cada coisa distinta aparece. E todas se resolvem com o mesmo padrão elegante, a contagem de frequência, que é o exemplo mais bonito do poder do dicionário. A sacada é usar o próprio item como chave e a quantidade como valor. Percorrendo a coleção, para cada item que aparece você soma um na contagem daquela chave. No fim, o dicionário guarda, para cada item distinto, quantas vezes ele apareceu. Um laço, um dicionário, e uma legião de problemas resolvida.

votos <- ["A", "B", "A", "C", "A", "B"]
contagem <- { }
para cada v em votos faça
  se v existe em contagem então
    contagem[v] <- contagem[v] + 1
  senão
    contagem[v] <- 1
  fim
fim
escreva(contagem)   // { "A": 3, "B": 2, "C": 1 }

Cada voto é uma chave; o valor é a contagem. Na primeira aparição começa em 1; nas seguintes, soma 1.

Uma fila de votos A, B, A, C, A, B sendo percorrida por uma seta, e um quadro de dicionário ao lado sendo preenchido. Ao passar cada voto, a barra da letra correspondente cresce: A chega a 3, B a 2, C a 1, formando um pequeno gráfico de contagem.
A cada item percorrido, a contagem da sua chave cresce. No fim, o dicionário tem a frequência de cada um.

O cuidado da primeira vez

O único ponto de atenção da contagem de frequência é a primeira aparição de cada item. Quando o voto A surge pela primeira vez, a chave A ainda não existe no dicionário, então não dá para somar um em algo que não está lá, seria como pôr uma moeda num cofrinho que não existe. Por isso o padrão trata dois casos: se a chave já existe, soma um na contagem; se é a primeira vez, cria a chave com a contagem um. É a mesma lógica de checar a existência que você viu antes, agora no coração da contagem. Muitas linguagens oferecem atalhos que fazem esse tratamento sozinhas (um valor padrão zero para chaves novas), mas entender o porquê do cuidado é o que evita o bug do começa somando no vazio.

🎮 Jogo da aula

Qual a frequência final?

Percorra a lista montando a contagem de frequência e escolha o dicionário resultante.

itens <- ["maca", "pera", "maca", "maca"]
c <- { }
para cada x em itens faça
  se x existe em c então
    c[x] <- c[x] + 1
  senão
    c[x] <- 1
  fim
fim
escreva(c)

Onde a contagem de frequência aparece

Depois de aprender esse padrão, você começa a enxergá-lo em todo lugar. A nuvem de palavras que destaca os termos mais frequentes de um texto é uma contagem de frequência. A apuração de uma eleição é uma contagem de votos por candidato. O relatório que mostra os produtos mais vendidos do mês conta unidades por produto. Até recursos de detecção, como perceber que uma palavra se repete demais ou que um endereço fez muitos acessos, nascem de contar frequência. É um daqueles padrões que, uma vez na cabeça, transforma problemas que pareciam complicados em um laço de poucas linhas. Guarde-o com carinho: ele vai aparecer no seu projeto final e na sua vida de programador.

Teste rápido

Na contagem de frequência, por que é preciso tratar de forma especial a PRIMEIRA vez que um item aparece?

Perguntas frequentes

O que é contagem de frequência, em uma frase?
É contar quantas vezes cada item distinto aparece numa coleção, usando um dicionário em que a chave é o item e o valor é a contagem. Percorrendo a coleção, cada aparição soma um na contagem da chave correspondente.
Por que usar dicionário e não uma lista para contar frequência?
Porque o dicionário busca a contagem de um item pela chave na hora, sem varrer. Com lista, você teria que procurar a posição de cada item a cada aparição, o que fica lento. O dicionário torna a contagem eficiente mesmo com muitos itens distintos, e o código fica curto e claro.
Como trato a primeira aparição de um item?
Verificando se a chave já existe. Se existe, soma um na contagem; se é a primeira vez, cria a chave com a contagem inicial (1). Algumas linguagens oferecem atalhos que assumem zero para chaves novas, o que dispensa o if, mas o conceito por trás é sempre esse cuidado com a estreia.
Depois de contar, como acho o item mais frequente?
Percorrendo o dicionário de contagens e guardando a maior, com o padrão do maior valor que você já usou: uma variável que começa pequena e é atualizada quando encontra uma contagem maior. No fim, você tem o item de maior frequência. É a contagem seguida de uma busca do máximo.
Serve para contar palavras num texto?
Serve, e é um uso clássico. Você quebra o texto em palavras (usando o que aprendeu no módulo de strings) e faz a contagem de frequência sobre elas: cada palavra é uma chave, o valor é quantas vezes apareceu. É assim que se descobre a palavra mais usada e se montam nuvens de palavras.
Esse padrão aparece em coisas do dia a dia?
Bastante: apuração de votos, produtos mais vendidos, termos mais buscados, músicas mais tocadas, até sistemas que detectam repetição suspeita. Sempre que a pergunta é quantas vezes cada coisa aparece, a contagem de frequência com dicionário é a resposta natural, curta e rápida.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.