continuous learning company
Voltar para publicações
Ana Clara
ana clara castro Conheça o autor

index() no Python: encontre a posição de um elemento

Descubra onde um valor aparece e diferencie posição de quantidade.

06/11/2026Desenvolvimento
index() no Python: primeira ocorrência, índices começando em zero e cuidado com ValueError

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.

🔎 Onde está a primeira pista?

Detetive das posições

Crie uma lista e descubra o índice do primeiro item que corresponde à sua busca.

Separe os itens por vírgulas, sem colchetes ou aspas. Todos serão textos. Espaços nas bordas são ignorados; maiúsculas e acentos fazem diferença. Até 20 itens.

O primeiro índice é 0. Se o item não existir, digite ausente.

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")?

2. Em ["azul", "verde", "azul"], index("azul") retorna o quê?

3. O que ocorre ao procurar com index() um valor ausente?

4. Qual é a diferença entre index() e count()?

5. O que ["a", "b", "a"].index("a", 1) retorna?

Para continuar estudando

Continue sua trilha

Trilha de Python · 0% concluído · 0 de 21 conteúdos concluídos