Domine a função enumerate() em Python: Guia completo com exemplos

Por

Dominando a Função enumerate() em Python: Um Guia Detalhado

Neste guia, você explorará a fundo a função enumerate() do Python, uma ferramenta essencial para programadores que desejam manipular iteráveis de forma eficiente. Esta função permite acessar elementos de sequências, como listas ou tuplas, juntamente com seus respectivos índices, simplificando tarefas comuns de iteração.

Começaremos analisando métodos tradicionais de iteração usando loops for, antes de nos aprofundarmos na sintaxe e nos benefícios da função enumerate(). Ao longo deste artigo, você encontrará exemplos práticos que ilustram o uso e a versatilidade dessa função.

Vamos dar o primeiro passo nessa jornada de aprendizado!

Iterando com Loops for em Python: Uma Revisão

Em Python, qualquer objeto que possa ser percorrido e que permita acessar seus elementos individualmente é considerado um iterável. Listas, tuplas, dicionários e strings são exemplos comuns de iteráveis.

Para demonstrar, vamos usar um exemplo simples: uma lista de compras:

lista_de_compras = ["frutas", "biscoitos", "cereais", "barras de proteína", "post-its"]

O loop for é uma ferramenta básica para iterar sobre esses objetos. A sintaxe geral para iteração é:

for item in <iteravel>:
    # Executar ações com o item

# item: variável de iteração
# <iteravel>: qualquer iterável do Python (lista, tupla, dicionário, string etc.)

Aplicando essa sintaxe à nossa lista de compras:

for item in lista_de_compras:
    print(item)

# Saída
frutas
biscoitos
cereais
barras de proteína
post-its

Embora esse método permita acessar os itens diretamente, muitas vezes é necessário acessar seus índices também.

Uma abordagem possível é usar uma variável de índice que é incrementada manualmente dentro do loop:

indice = 0
for item in lista_de_compras:
  print(f"índice:{indice}, {item}")
  indice += 1

# Saída
índice:0, frutas
índice:1, biscoitos
índice:2, cereais
índice:3, barras de proteína
índice:4, post-its

No entanto, essa abordagem é suscetível a erros. Esquecer de incrementar o índice pode levar a resultados inesperados:

indice = 0
for item in lista_de_compras:
  print(f"índice:{indice}, {item}")
  # Erro: o índice não é atualizado

# Saída (incorreta)
índice:0, frutas
índice:0, biscoitos
índice:0, cereais
índice:0, barras de proteína
índice:0, post-its

Outra prática comum é usar loops for em conjunto com a função range(), que exploraremos a seguir.

Acessando Índices com a Função range()

A função integrada len() do Python retorna o comprimento de um iterável. Podemos usar len(lista_de_compras) para obter o número de elementos (5 neste caso).

len(lista_de_compras)
# Saída: 5

A função range() gera uma sequência de números que podemos usar em um loop. Quando iteramos sobre range(n), obtemos os índices 0, 1, 2,…, n-1. Usando range(len(lista)), podemos obter todos os índices válidos.

Assim, com a função range(), podemos acessar tanto o índice quanto o item correspondente:

for indice in range(len(lista_de_compras)):
  print(f"índice:{indice}, item: {lista_de_compras[indice]}")

# Saída
índice:0, item: frutas
índice:1, item: biscoitos
índice:2, item: cereais
índice:3, item: barras de proteína
índice:4, item: post-its

No entanto, essa abordagem não é considerada a forma mais elegante e eficiente de acessar índices e itens simultaneamente em Python.

Entendendo a Sintaxe da Função enumerate()

A função enumerate() do Python oferece uma maneira mais concisa e eficiente de acessar itens e seus índices. A sintaxe geral é:

enumerate(<iteravel>, start=0)
  • <iteravel> é um parâmetro obrigatório, que pode ser qualquer iterável, como uma lista ou tupla.
  • start é um parâmetro opcional que especifica o valor inicial do índice. O valor padrão é 0.

Ao chamar enumerate(lista_de_compras), obtemos um objeto enumerate:

enumerate(lista_de_compras)
# Saída: <enumerate at 0x7f91b4240410>

Não podemos iterar diretamente sobre este objeto enumerate. Uma opção é convertê-lo em uma lista:

list(enumerate(lista_de_compras))
# Saída
[(0, 'frutas'), (1, 'biscoitos'), (2, 'cereais'), (3, 'barras de proteína'), (4, 'post-its')]

Outra forma de acessar os itens é usando a função next(), que retorna o próximo item de um iterador.

Vamos atribuir o objeto enumerate a uma variável:

lista_de_compras_enum = enumerate(lista_de_compras)

Cada chamada de next(lista_de_compras_enum) retornará uma tupla contendo o índice e o item correspondente:

next(lista_de_compras_enum)
# Saída: (0, 'frutas')
next(lista_de_compras_enum)
# Saída: (1, 'biscoitos')
next(lista_de_compras_enum)
# Saída: (2, 'cereais')
next(lista_de_compras_enum)
# Saída: (3, 'barras de proteína')
next(lista_de_compras_enum)
# Saída: (4, 'post-its')

Quando não há mais itens, a função next() levanta uma exceção StopIteration.

next(lista_de_compras_enum)
# Saída: StopIteration

A função enumerate() retorna os índices e itens de forma “preguiçosa”, somente quando necessário, o que é ideal para iteráveis grandes, otimizando o uso da memória.

Exemplos Práticos da Função enumerate()

Agora que entendemos a sintaxe básica, vamos refinar nosso loop for usando a função enumerate(). Como vimos, o objeto enumerate retorna tuplas que podem ser desempacotadas:

for indice, item in enumerate(lista_de_compras):
  print(f"índice:{indice}, item:{item}")

# Saída
índice:0, item:frutas
índice:1, item:biscoitos
índice:2, item:cereais
índice:3, item:barras de proteína
índice:4, item:post-its

Personalizando o Valor Inicial com enumerate()

Por padrão, a contagem começa em 0. No entanto, podemos especificar um valor inicial diferente:

for indice, item in enumerate(lista_de_compras, 1):
  print(f"índice:{indice}, item:{item}")

# Saída
índice:1, item:frutas
índice:2, item:biscoitos
índice:3, item:cereais
índice:4, item:barras de proteína
índice:5, item:post-its

Ao personalizar o valor inicial, certifique-se de que ele seja o segundo argumento posicional. Inverter a ordem pode levar a erros.

for indice, item in enumerate(1, lista_de_compras):
  print(f"índice:{indice}, item:{item}")

# Saída: TypeError: 'list' object cannot be interpreted as an integer

Para evitar esses problemas, use o parâmetro start com nome:

for indice, item in enumerate(lista_de_compras, start=1):
  print(f"índice:{indice}, item:{item}")

# Saída
índice:1, item:frutas
índice:2, item:biscoitos
índice:3, item:cereais
índice:4, item:barras de proteína
índice:5, item:post-its

Até agora, usamos enumerate() com listas. Essa função também é compatível com tuplas, strings e outros iteráveis.

Utilizando enumerate() com Tuplas

Se lista_de_compras for uma tupla, o comportamento da função enumerate() permanece o mesmo. Tuplas são imutáveis, o que significa que não podem ser modificadas após a criação.

lista_de_compras = ("frutas", "biscoitos", "cereais", "barras de proteína", "post-its")
type(lista_de_compras)
# Saída: tuple

Tentar modificar uma tupla gerará um erro:

lista_de_compras[0] = 'vegetais'
# Saída: TypeError: 'tuple' object does not support item assignment

No entanto, podemos usar enumerate() sem problemas:

lista_de_compras = ("frutas","biscoitos","cereais","barras de proteína","post-its")
for indice, item in enumerate(lista_de_compras):
    print(f"índice:{indice}, item:{item}")

Aplicando enumerate() a Strings

A função enumerate() também pode ser usada para percorrer strings e acessar seus caracteres e índices:

string_exemplo = "Borboleta"
for indice, caractere in enumerate(string_exemplo):
  print(f"índice {indice}: {caractere}")
# Saída
índice 0: B
índice 1: o
índice 2: r
índice 3: b
índice 4: o
índice 5: l
índice 6: e
índice 7: t
índice 8: a

Conclusão

Aqui está um resumo dos pontos chave que abordamos:

  • Loops for são usados para iterar sobre sequências, podendo ser combinados com um contador ou variável de índice manual.
  • A função range() permite gerar uma sequência de índices para acessar itens em uma lista.
  • A função enumerate() é a maneira Pythonic recomendada para acessar índices e itens simultaneamente, com a sintaxe enumerate(iterável), com início padrão em 0.
  • Podemos personalizar o valor inicial com enumerate(iterável, start).
  • enumerate() pode ser usado com tuplas, strings e qualquer iterável em Python.

Espero que este guia detalhado sobre a função enumerate() tenha sido útil. Agora, você está pronto para usar essa ferramenta em seus projetos Python. Continue praticando e explorando!