index() no Python: encontre a posição de um elemento
Descubra onde um valor aparece e diferencie posição de quantidade.
06/11/2026Desenvolvimento
Imagine uma lista de compras: você sabe que precisa de banana, mas quer descobrir em qual posição ela está. Não quer contar todas as bananas nem retirar uma fruta. Para essa pergunta, o Python oferece index(). Ele procura um valor e devolve o índice da primeira ocorrência, começando a contagem em zero.
1. O que index() faz?
Em uma lista, escrevemos lista.index(valor). O método procura um elemento igual ao valor informado e retorna um número inteiro que representa a posição. Ele não devolve o elemento e não modifica a lista. Se não houver correspondência, a chamada gera ValueError; não retorna zero, menos um ou uma lista vazia.
2. Encontrando uma fruta
frutas = ["maçã", "banana", "uva"]
posicao = frutas.index("banana")
print(posicao)
# 1
print(frutas[posicao])
# banana
A maçã ocupa o índice zero, a banana ocupa o índice um e a uva ocupa o índice dois. Por isso, a consulta retorna 1. Guardamos esse índice na variável posicao e usamos colchetes para acessar o elemento correspondente. São operações diferentes: index() descobre uma posição pelo valor; frutas[posicao] acessa um valor pela posição.
3. Por que o primeiro índice é zero?
A primeira posição da lista tem índice zero; a segunda tem índice um; a terceira tem índice dois. Em uma lista com três elementos, os índices positivos válidos são zero, um e dois. Não confunda a posição na linguagem cotidiana com o número usado no código.
nomes = ["Ana", "Bruna", "Carlos"]
print(nomes.index("Ana"))
# 0
print(nomes[0])
# Ana
Retornar zero é um resultado válido: significa que o valor foi encontrado no primeiro elemento. Por isso, não use apenas if posicao: para decidir se a busca deu certo. Zero é considerado falso em uma condição, embora represente uma ocorrência encontrada.
4. Valores repetidos: vale a primeira ocorrência
frutas = ["maçã", "banana", "uva", "banana"]
print(frutas.index("banana"))
# 1
Há duas bananas, nos índices um e três. Sem limitar a busca, index() devolve um: a primeira ocorrência. Ele não retorna uma lista de posições nem a quantidade de repetições. A ordem dos elementos importa para saber qual correspondência será encontrada primeiro.
5. Também funciona com números
numeros = [10, 20, 30, 20]
print(numeros.index(20))
# 1
O número vinte aparece pela primeira vez no índice um. Observe que ele foi escrito sem aspas. Se a lista contivesse o texto "20", seria outro valor: número e texto não são iguais nessa comparação. Escolha o valor procurado de acordo com os dados guardados na lista.
6. E se o valor não existir?
Chamar frutas.index("laranja") em uma lista sem laranja gera ValueError. Isso é diferente de acessar um índice fora da lista com colchetes, situação que pode gerar IndexError. Uma busca por valor ausente e um acesso a posição inexistente não são o mesmo problema.
frutas = ["maçã", "banana", "uva"]
try:
posicao = frutas.index("laranja")
print(posicao)
except ValueError:
print("Fruta não encontrada.")
# Fruta não encontrada.
O bloco try tenta fazer a consulta. Quando o valor está ausente, except ValueError trata esse caso e mostra uma mensagem. Esse tratamento específico evita esconder outros erros que merecem investigação. Uma lista vazia também gera ValueError ao buscar qualquer elemento com index().
7. Uma alternativa simples: verificar com in
frutas = ["maçã", "banana", "uva"]
procurada = "laranja"
if procurada in frutas:
print(frutas.index(procurada))
else:
print("Fruta não encontrada.")
# Fruta não encontrada.
O operador in responde se o valor está presente. Só chamamos index() quando essa verificação é verdadeira. É uma alternativa fácil de acompanhar em exemplos pequenos. Quando você precisa apenas saber se existe, use in sozinho; não é necessário descobrir a posição. Quando precisa do índice, o tratamento com try e except evita uma busca prévia adicional.
8. Buscando um trecho dentro de um texto
texto = "Aprender Python"
print(texto.index("Python"))
# 9
Strings também têm index(). Nesse caso, a busca encontra um trecho e retorna o índice do seu início. Em “Aprender Python”, as oito letras de Aprender ocupam os índices zero a sete, o espaço ocupa o índice oito e o P de Python está no índice nove. Espaços fazem parte do texto. Maiúsculas, minúsculas e acentos também influenciam a correspondência.
Os índices de uma string Python consideram pontos de código Unicode, não necessariamente os símbolos visuais percebidos pelo leitor. Para os textos simples deste exemplo, você pode acompanhar as letras e o espaço. Em uma lista de textos, a busca compara o elemento inteiro: procurar "banana" não encontra um elemento que seja apenas "bananada".
9. index() e find(): parecidos, mas não idênticos
texto = "Aprender Python"
print(texto.find("Java"))
# -1
try:
print(texto.index("Java"))
except ValueError:
print("Trecho não encontrado.")
# Trecho não encontrado.
Em strings, find() retorna menos um quando o trecho está ausente. Já index() gera ValueError. Quando encontram o trecho, ambos retornam seu índice inicial. Listas não têm o método find(): não transfira essa alternativa de textos para listas. E cuidado ao usar menos um como índice: em Python, ele acessa o último elemento, não significa automaticamente “não encontrado”.
10. index() ou count(): onde está ou quantos existem?
cores = ["azul", "verde", "azul", "amarelo", "azul"]
print(cores.index("azul"))
# 0
print(cores.count("azul"))
# 3
print(cores.count("roxo"))
# 0
index("azul") devolve zero porque azul está no primeiro elemento. count("azul") devolve três porque há três ocorrências. As duas chamadas retornam inteiros, mas esses números respondem a perguntas diferentes. Para roxo, count retorna zero; index geraria ValueError. Nenhum dos dois métodos remove, ordena ou altera os elementos consultados.
11. Próximo passo: limitar a busca
frutas = ["maçã", "banana", "uva", "banana"]
print(frutas.index("banana", 2))
# 3
O segundo argumento indica o índice onde a busca deve começar. Aqui, pulamos a primeira banana e começamos no índice dois; a próxima banana está no índice três. O resultado continua sendo relativo à lista inteira, não ao início do intervalo. Também é possível passar um terceiro argumento para o limite final, que não é incluído na busca. Se o valor só existir fora do intervalo escolhido, a chamada gera ValueError.
12. Jogo: detetive das posições
Monte sua própria lista de palavras, escolha o item que quer encontrar e digite o índice da primeira ocorrência. Se ele não estiver na lista, escreva “ausente”. Depois da tentativa, o jogo revela os índices e destaca a primeira correspondência. Você pode editar os dados e abrir um novo caso sem perder pontos.
Detetive das posições
Crie uma lista e descubra o índice do primeiro item que corresponde à sua busca.
O caso está aberto. Digite seu palpite para investigar!
Sem cronômetro e sem perder pontos. Simulação local em JavaScript: não executa Python, não salva nem envia os textos digitados.
Resumo para revisar
- index(): retorna o índice da primeira ocorrência na busca.
- Contagem de posições: começa em zero.
- Valor ausente: gera ValueError, inclusive em listas vazias.
- Dados preservados: a consulta não remove nem reorganiza elementos.
- Em strings: retorna o início do trecho encontrado.
- count(): conta ocorrências, em vez de informar uma posição.
- Busca limitada: o índice retornado continua relativo à sequência original.
Teste seu conhecimento
Responda às cinco questões e confira as explicações.
1. Qual é o retorno de ["maçã", "banana", "uva"].index("banana")?
Resposta correta: B) 1.
A contagem começa em zero: maçã é 0 e banana é 1.
2. Em ["azul", "verde", "azul"], index("azul") retorna o quê?
Resposta correta: A) 0, o índice da primeira ocorrência.
index() retorna um único índice: o da primeira ocorrência na busca.
3. O que ocorre ao procurar com index() um valor ausente?
Resposta correta: D) Gera ValueError.
Valor ausente gera ValueError. Zero é um índice válido, e menos um não é o retorno de index().
4. Qual é a diferença entre index() e count()?
Resposta correta: C) index() informa uma posição; count() informa uma quantidade.
Os dois retornam inteiros, mas respondem onde está e quantos existem, respectivamente.
5. O que ["a", "b", "a"].index("a", 1) retorna?
Resposta correta: B) 2, o índice na lista original.
A busca começa no índice 1 e encontra a no índice 2. O retorno continua relativo à lista inteira.
Para continuar estudando
Continue sua trilha
Trilha de Python · 0% concluído · 0 de 21 conteúdos concluídos
Você concluiu: ✓ index() no Python: encontre a posição de um elemento