Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

str.index

Devolve o primeiro índice da subcadeia dentro dos limites, contado a partir do início do texto original.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

s.index(sub[, start[, end]])

Devolve o primeiro índice da subcadeia dentro dos limites, contado a partir do início do texto original.

Uma pesquisa sem resultado gera ValueError, útil quando a ausência deve interromper o processamento normal.

Os limites opcionais start e end restringem a pesquisa e excluem end. Em cacao, começar em 1 ignora o primeiro ca e encontra o seguinte em 2. A ausência de z aciona o tratamento de exceções em vez de devolver −1.

Exemplos

print("cacao".index("ca", 1))
try:
    "cacao".index("z")
except ValueError as error:
    print(type(error).__name__)

Resultado

2
ValueError

Os limites opcionais start e end restringem a pesquisa e excluem end. Em cacao, começar em 1 ignora o primeiro ca e encontra o seguinte em 2. A ausência de z aciona o tratamento de exceções em vez de devolver −1.

Fontes