Método list index() do Python explicado com exemplos

O que é a função index()?

O método index() retorna o índice mais baixo da lista em que aparece o elemento pesquisado.

Vamos experimentar:

list_numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
element = 3
list_numbers.index(element)

2

Se algum elemento que não estiver presente for pesquisado, você receberá um ValueError.

list_numbers = [4, 5, 6, 7, 8, 9, 10]
element = 3 # Not in the list
list_numbers.index(element) # Throws a ValueError

---------------------------------------------------------------------------

ValueError                                Traceback (most recent call last)

<ipython-input-35-6a006c988b06> in <module>()
      1 list_numbers = [4, 5, 6, 7, 8, 9, 10]
      2 element = 3 # Not in the list
----> 3 list_numbers.index(element) # Throws a ValueError


ValueError: 3 is not in list

Trabalhando com cordas

Vamos tentar fazer isso com elementos de string:

list_numbers = [1, 'two', 3, 4, 5, 6, 7, 8, 9, 10]
element = 'two'
list_numbers.index(element)

1

Observação: Ao pesquisar cadeias de caracteres, o site index() diferencia maiúsculas de minúsculas. Por exemplo, 'Hello'.index('h') criará um ValueError.

Como encontrar a primeira ocorrência

Se você tiver mais de uma instância de um elemento, o site index() fornecerá a primeira posição em que o elemento aparece.

list_numbers = [3, 1, 2, 3, 3, 4, 5, 6, 3, 7, 8, 9, 10]
element = 3
list_numbers.index(element)

0

A posição retornada é 0, porque 3 aparece pela primeira vez na primeira posição ou no 0º índice em Python.

Aqui está o que está acontecendo internamente: O índice percorre todos os valores a partir da 1ª posição (0º índice), procurando o elemento que você está pesquisando. Quando você encontra o valor, ele retorna a posição e sai do sistema. No entanto, isso não é muito eficiente quando se percorre uma lista grande e você precisa obter a posição de algo no final da lista.

Usando parâmetros de início e parada

list_numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
element = 7
list_numbers.index(element, 5, 8)

6

Portanto, a sintaxe é. : list_name.index(element, start, stop).

Aqui, os valores start e stop são opcionais. Na verdade, use-o somente quando tiver certeza absoluta do alcance; caso contrário, você receberá um ValueError, conforme mostrado abaixo.

list_numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
element = 7
list_numbers.index(element, 1, 5)

---------------------------------------------------------------------------

ValueError                                Traceback (most recent call last)

<ipython-input-39-b96f4b5e51d5> in <module>()
      1 list_numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
      2 element = 7
----> 3 list_numbers.index(element, 1, 5)


ValueError: 7 is not in list

Como encontrar todas as ocorrências

Como o index() retorna apenas a primeira correspondência de um objeto, você pode usar a compreensão de lista ou a expressão do gerador se precisar das posições de mais correspondências na lista. Veja como:

list_numbers = [3, 1, 2, 3, 3, 4, 5, 6, 3, 7, 8, 9, 10]
[i for i, n in enumerate(list_numbers) if n == 3] # List comprehension

[0, 3, 4, 8]

list_numbers = [3, 1, 2, 3, 3, 4, 5, 6, 3, 7, 8, 9, 10]
g = (i for i, n in enumerate(list_numbers) if n == 3) # Generator expression
print("Generators store values, the first value here is:", next(g), ". Then the next is:", next(g), "followed by ", next(g),"and finally ", next(g))

Generators store values, the first value here is: 0. Then the next is: 3 followed by  4 and finally  8

Os geradores são eficientes em termos de memória porque produzem itens um de cada vez, em vez de armazenar todos os resultados, como as compreensões de lista.

Considerações finais

Parabéns, você acabou de aprender sobre a função index() em Python! Você já viu como ele pode ajudá-lo a trabalhar com listas. Você também foi apresentado a alguns novos conceitos. Para saber mais sobre a compreensão de listas, confira o tutorial de compreensão de listas do Python da DataCamp. No tutorial Python Iterator da DataCamp, você encontra mais informações sobre geradores e expressões de geradores.