Python Counter – Python Coleções Counter

A classe Python Counter faz parte do módulo Collections. Counter é uma subclasse de Dictionary e é usada para acompanhar elementos e suas contagens.

Python Counter

Counter é uma coleção não ordenada onde os elementos são armazenados como chaves Dict e suas contagens como valores de dicionário. A contagem dos elementos do Counter pode ser de números inteiros positivos, zero ou negativos. No entanto, não há restrição para as chaves e valores. Embora os valores sejam destinados a serem números, podemos armazenar outros objetos também.

Criando um Objeto Counter em Python

Podemos criar um Counter vazio ou começar com alguns valores iniciais também.

from collections import Counter

# Counter vazio
counter = Counter()
print(counter)  # Counter()

# Counter com valores iniciais
counter = Counter(['a', 'a', 'b'])
print(counter)  # Counter({'a': 2, 'b': 1})

counter = Counter(a=2, b=3, c=1)
print(counter)  # Counter({'b': 3, 'a': 2, 'c': 1})

Também podemos usar qualquer iterável como argumento para criar um objeto Counter. Portanto, literal de string e List também podem ser usados para criar um objeto Counter.

# Iterável como argumento para Counter
counter = Counter('abc')
print(counter)  # Counter({'a': 1, 'b': 1, 'c': 1})

# Lista como argumento para Counter
words_list = ['Cat', 'Dog', 'Horse', 'Dog']
counter = Counter(words_list)
print(counter)  # Counter({'Dog': 2, 'Cat': 1, 'Horse': 1})

# Dicionário como argumento para Counter
word_count_dict = {'Dog': 2, 'Cat': 1, 'Horse': 1}
counter = Counter(word_count_dict)
print(counter)  # Counter({'Dog': 2, 'Cat': 1, 'Horse': 1})

Como mencionei anteriormente, também podemos usar dados não numéricos para os valores de contagem, mas isso defeituará o propósito da classe Counter.

# Counter funciona com não números
special_counter = Counter(name='Pankaj', age=20)
print(special_counter)  # Counter({'name': 'Pankaj', 'age': 20})

Métodos do Counter em Python

Vamos analisar os métodos da classe Counter e algumas outras operações que podemos realizar com ela.

Obtendo Contagem de Elementos

# obtendo contagem
counter = Counter({'Dog': 2, 'Cat': 1, 'Horse': 1})
countDog = counter['Dog']
print(countDog)  # 2

Se tentarmos obter a contagem de uma chave que não existe, ela retornará 0 e não lançará KeyError.

# obtendo contagem para chave não existente, não gera KeyError
print(counter['Unicorn'])  # 0

Configurando a Contagem de Elementos

Também podemos definir a contagem de um elemento existente no contador. Se o elemento não existir, ele será adicionado ao contador.

counter = Counter({'Dog': 2, 'Cat': 1, 'Horse': 1})
# configurando contagem
counter['Horse'] = 0
print(counter)  # Counter({'Dog': 2, 'Cat': 1, 'Horse': 0})

# configurando contagem for non-existing key, adds to Counter
counter['Unicorn'] = 1
print(counter)  # Counter({'Dog': 2, 'Cat': 1, 'Unicorn': 1, 'Horse': 0})

Excluindo um elemento do Contador

Podemos usar del para excluir um elemento do objeto contador.

# Excluir elemento do Contador
del counter['Unicorn']
print(counter)  # Counter({'Dog': 2, 'Cat': 1, 'Horse': 0})

elements()

Este método retorna a lista de elementos no contador. Apenas elementos com contagens positivas são retornados.

counter = Counter({'Dog': 2, 'Cat': -1, 'Horse': 0})

# elements()
elements = counter.elements()  # doesn't return elements with count 0 or less
for value in elements:
    print(value)

O código acima imprimirá “Cão” duas vezes porque sua contagem é 2. Outros elementos serão ignorados porque não têm contagem positiva. O contador é uma coleção não ordenada, então os elementos são retornados sem ordem específica.

most_common(n)

Este método retorna os elementos mais comuns do contador. Se não fornecermos o valor de ‘n’, então um dicionário ordenado é retornado, dos elementos mais comuns aos menos comuns. Podemos usar a indexação para obter os elementos menos comuns neste dicionário ordenado.

counter = Counter({'Dog': 2, 'Cat': -1, 'Horse': 0})

# most_common()
most_common_element = counter.most_common(1)
print(most_common_element)  # [('Dog', 2)]

least_common_element = counter.most_common()[:-2:-1]
print(least_common_element)  # [('Cat', -1)]

subtract() e update()

O método subtract() do Counter é usado para subtrair contagens de outro contador. O método update() é usado para adicionar contagens de outro contador.

counter = Counter('ababab')
print(counter)  # Counter({'a': 3, 'b': 3})
c = Counter('abc')
print(c)  # Counter({'a': 1, 'b': 1, 'c': 1})

# subtract
counter.subtract(c)
print(counter)  # Counter({'a': 2, 'b': 2, 'c': -1})

# update
counter.update(c)
print(counter)  # Counter({'a': 3, 'b': 3, 'c': 0})

Operações Aritméticas do Contador Python

Também podemos realizar algumas operações aritméticas em Contadores, assim como números. No entanto, apenas elementos com contagem positiva são retornados com essas operações.

# operações aritméticas
c1 = Counter(a=2, b=0, c=-1)
c2 = Counter(a=1, b=-1, c=2)

c = c1 + c2  # return items having +ve count only
print(c)  # Counter({'a': 3, 'c': 1})

c = c1 - c2  # keeps only +ve count elements
print(c)  # Counter({'a': 1, 'b': 1})

c = c1 & c2  # intersection min(c1[x], c2[x])
print(c)  # Counter({'a': 1})

c = c1 | c2  # union max(c1[x], c2[x])
print(c)  # Counter({'a': 2, 'c': 2})

Operações Diversas no Contador Python

Vamos dar uma olhada em alguns trechos de código para operações diversas que podemos realizar em objetos Counter.

counter = Counter({'a': 3, 'b': 3, 'c': 0})
# exemplos diversos
print(sum(counter.values()))  # 6

print(list(counter))  # ['a', 'b', 'c']
print(set(counter))  # {'a', 'b', 'c'}
print(dict(counter))  # {'a': 3, 'b': 3, 'c': 0}
print(counter.items())  # dict_items([('a', 3), ('b', 3), ('c', 0)])

# remover elementos com contagem 0 ou negativa
counter = Counter(a=2, b=3, c=-1, d=0)
counter = +counter
print(counter)  # Counter({'b': 3, 'a': 2})

# limpar todos os elementos
counter.clear()
print(counter)  # Counter()

Isso é tudo para a classe Counter do Python.

Você pode baixar o código de exemplo completo do meu Repositório no GitHub.

Referência: Python Docs

Source:
https://www.digitalocean.com/community/tutorials/python-counter-python-collections-counter