CKTIS / Java
String.indexOf — encontrar uma subcadeia
String.indexOf devolve o índice da primeira correspondência da subcadeia ou -1. O parâmetro fromIndex permite iniciar a pesquisa numa posição especificada.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);String.indexOf(str) encontra a primeira correspondência da subcadeia; String.indexOf(str, fromIndex) pesquisa a partir de fromIndex, inclusive. O resultado é um índice baseado em zero na cadeia completa ou -1. Verifique position >= 0, não position > 0: a posição 0 é uma correspondência válida.
A pesquisa é literal, distingue maiúsculas de minúsculas e não interpreta expressões regulares. Os índices contam unidades de código UTF-16 (char), que nem sempre correspondem a caracteres Unicode completos. Um fromIndex negativo funciona como 0; se str não estiver vazia, um índice superior ao comprimento da cadeia devolve -1. Um índice fora dos limites, por si só, não causa uma exceção.
Se str estiver vazia, o resultado é Math.min(Math.max(fromIndex, 0), text.length()). Um argumento null para str causa uma NullPointerException. Para encontrar a correspondência seguinte, que pode sobrepor-se, de uma subcadeia não vazia, comece em position + 1 após uma correspondência bem-sucedida.
Exemplos
public class Main {
public static void main(String[] args) {
String text = "banana";
int first = text.indexOf("ana");
int next = text.indexOf("ana", first + 1);
System.out.println(first);
System.out.println(next);
System.out.println(text.indexOf("ANA"));
System.out.println(text.indexOf("", 99));
}
}Resultado
1 3 -1 6
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.