tuple.index() Localizar posição do elemento
Última atualização: 2026-09-22
tuple.index() Localizar posição do elemento
tuple.index(x[, start[, end]]) Retorna o índice da primeira ocorrência de x; lança ValueError se não encontrar.
| Categoria | Métodos de tupla |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
tuple.index(x[, start[, end]])⚙️ Parâmetros
| x Obrigatório | The element to search for. |
|---|---|
| start Opcional | Start index (inclusive); optional.（Padrão：0） |
| end Opcional | End index (exclusive); None means to the end.（Padrão：None） |
Retorno：int. The first index of x; raises ValueError if not found.
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
ValueError— Raised when x is not in the tuple.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
1💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que acontece quando o elemento não está na tupla?
AÉ lançado `ValueError: tuple.index(x): x not in tuple`.
QOs parâmetros `start`/`end` são suportados?
ASim: `t.index(x, start, end)` delimita o intervalo de busca (fechado à esquerda, aberto à direita); se não encontrar, ainda assim lança `ValueError`.
QComo pesquisar com segurança?
AVerifique com `in` primeiro: `if x in t: i = t.index(x)`; ou capture a `ValueError` com `try/except`.
