Python list.count(): Guia Especializado com Exemplos Práticos

O que é list.count()

O método embutido list.count() do Python retorna o número de vezes que um elemento especificado aparece em uma lista. Também funciona em strings, tornando-se uma ferramenta versátil para análise de dados, processamento de texto e mais.

Como Funciona

Sintaxe: list_obj.count(elemento)

Parâmetro: elemento — o valor cujas ocorrências você deseja contar.

Valor de Retorno: Um inteiro representando a contagem, ou 0 se o elemento estiver ausente.

Exemplo 1: Contando Cores em uma Lista

colors = ['red', 'green', 'blue', 'orange', 'green', 'gray', 'green']
green_count = colors.count('green')
print('The count of green:', green_count)

Saída:

The count of green: 3

Exemplo 2: Contando Números Duplicados

numbers = [2, 3, 4, 3, 10, 3, 5, 6, 3]
threes = numbers.count(3)
print('The count of 3:', threes)

Saída:

The count of 3: 4

Quando Usar list.count()

• Encontrar rapidamente a frequência de um valor específico.
• Validar se uma lista contém duplicatas esperadas.
• Integrar com pipelines de dados onde frequências de elementos direcionam lógica.

Nota de Performance

O método percorre toda a lista, então sua complexidade de tempo é O(n). Para grandes conjuntos de dados, considere usar collections.Counter para contagens de múltiplos elementos.

Resumo

• list.count() é uma forma confiável e embutida de obter frequências de elementos.
• Retorna um inteiro e funciona tanto em listas quanto em strings.
• Use quando precisar de uma contagem rápida de um único valor.