list.index() Encontra a primeira posição de um elemento
Última atualização: 2026-09-22
list.index() Encontra a primeira posição de um elemento
list.index(x[, start[, end]]) retorna o índice da primeira ocorrência de x; lança ValueError se não encontrado.
| Categoria | Métodos de lista |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
list.index(x[, start[, end]])⚙️ Parâmetros
| value Obrigatório | The element to search for. |
|---|---|
| start Opcional | Start index for the search; default is from the beginning.（Padrão：None） |
| end Opcional | End index (exclusive); default is to the end.（Padrão：None） |
Retorno：int, the index of the first occurrence of value.
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
ValueError— Raised when value is not in the list (or the given range).
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
1
err: 3 is not in list💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que acontece quando o elemento não está na lista?
AUm ValueError: x is not in list é lançado.
QComo procurar com segurança a posição de um elemento?
AVerifique com in primeiro: if x in lst: i = lst.index(x); ou capture ValueError com try/except.
QComo são usados os parâmetros start/end?
AEles delimitam o intervalo de busca (fechado à esquerda, aberto à direita): [10, 20, 30, 20].index(20, 2) começa a busca a partir do índice 2 e retorna 3.
QComo encontrar a última ocorrência?
AListas não possuem rindex(); você pode pesquisar na ordem inversa: len(lst) - 1 - lst[::-1].index(x).
