Python enumerate(): Como enumerar e listar objetos

Python enumerate() é usada para retornar uma entrada como objeto enumerado. Com a função integrada, você pode enumerar strings, listas e outros.

O que é Python enumerate()?

A função Python enumerate() é usada para trans­for­mar uma entrada em um objeto enumerado. Os objetos, que podem ser strings e tuplas Python, por exemplo, são numerados se­quen­ci­al­mente, começando de um valor inicial.. A enu­me­ra­ção é contínua e começa, por padrão, em “0”. A função já está incluída nessa linguagem de pro­gra­ma­ção.

Sintaxe e pa­râ­me­tros de Python enumerate()

A sintaxe da função Python enumerate() é a seguinte:

enumerate(iterable, start)

Ela possui dois pa­râ­me­tros:

• iterable: é um objeto ou uma sequência que pode ser per­cor­rida em um loop. A enu­me­ra­ção será adi­ci­o­nada a este parâmetro pos­te­ri­or­mente. Ele é obri­ga­tó­rio.
• start: é um parâmetro opcional. Você pode definir com ele a partir de qual valor numérico a numeração deve começar. O valor padrão é “0”.

Exemplo de enu­me­ra­ção com Python enumerate()

Para ilustrar o fun­ci­o­na­mento da função, ela­bo­ra­mos um exemplo simples com quatro cores di­fe­ren­tes. Vamos enumerá-las usando Python enumerate(). O código cor­res­pon­dente é o seguinte:

colors = ['Blue', 'Red', 'Yellow', 'Orange']
sequence = enumerate(colors)
print(list(sequence))

Com isso, obtemos a seguinte saída:

[(0, 'Blue'), (1, 'Red'), (2, 'Yellow'), (3, 'Orange')]

Python enumerate() com índice inicial

Como não definimos um índice inicial, a enu­me­ra­ção começa em “0”. Para alterar isso, adi­ci­o­na­mos o parâmetro start com o valor “1” ao Python enumerate(). Para isso, alteramos o código acima apenas li­gei­ra­mente:

colors = ['Blue', 'Red', 'Yellow', 'Orange']
sequence = enumerate(colors, 1)
print(list(sequence))

Nossa saída já parece um pouco mais or­ga­ni­zada:

[(1, 'Blue'), (2, 'Red'), (3, 'Yellow'), (4, 'Orange')]

Você pode ajustar o índice inicial como desejar, per­mi­tindo que a enu­me­ra­ção comece em qualquer outro valor.

Python enumerate() com loop for

Em com­bi­na­ção com um loop for Python, podemos usar enumerate() com e sem índice inicial ao mesmo tempo. Para o primeiro loop, omitimos o parâmetro start, fazendo com que a contagem comece em “0”. Para o segundo loop, incluímos o parâmetro com o ponto de partida “5”, fazendo com que essa contagem comece neste valor. Com a marcação "\n", ins­truí­mos o sistema a criar uma nova linha a cada vez, para que o resultado fique mais or­ga­ni­zado. Aqui está o código para essa com­bi­na­ção:

colors = ['Blue', 'Red', 'Yellow', 'Orange']
for sequence in enumerate(colors):    
    print(sequence, "\n")
print("It continues from 5")        
for sequence in enumerate(colors, 5):
    print(sequence)
    print("\n")

A saída:

(0, 'Blue')
(1, 'Red')
(2, 'Yellow')
(3, 'Orange')
It continues from 5
(5, 'Blue')
(6, 'Red')
(7, 'Yellow')
(8, 'Orange')

Enumerar uma string com Python enumerate()

Se você deseja enumerar uma string, Python enumerate() também é a escolha certa, a função divide a string em ca­rac­te­res in­di­vi­du­ais e os enumera. Veja como o código cor­res­pon­dente é:

string = "example" 
for x in enumerate(string, 1): 
    print(x)

A saída será:

(1, 'e') 
(2, 'x') 
(3, 'a') 
(4, 'm') 
(5, 'p') 
(6, 'l') 
(7, 'e')