str.rindex() Busca reversa (erro se não encontrado)
Última atualização: 2026-09-22
str.rindex() Busca reversa (erro se não encontrado)
str.rindex(sub) é semelhante a rfind(), mas lança ValueError se não encontrado.
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.rindex(sub[, start[, end]])⚙️ Parâmetros
| sub Obrigatório | The substring to search for. |
|---|---|
| start Opcional | Start index of the range (inclusive); None means the beginning.（Padrão：None） |
| end Opcional | End index of the range (exclusive); None means the end.（Padrão：None） |
Retorno：int. The highest index where sub is found; raises ValueError if absent.
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
ValueError— Raised when sub is not found in the range.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
3
err: substring not found💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQual é a diferença entre rindex() e rfind()?
AAmbos pesquisam da direita para a esquerda pela última ocorrência, mas quando não encontram, rindex() lança ValueError enquanto rfind() retorna -1.
QQuando devo usar rindex()?
AUse rindex() quando for certo que o substring existe (por exemplo, um marcador que deve aparecer em um template), para que não encontrá-lo gere um erro imediato e exponha o problema; use rfind() quando não houver certeza.
QQual é a relação entre rindex() e index()?
Aindex() procura a primeira ocorrência, rindex() a última; quando não a encontram, ambos lançam ValueError.
