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

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.

Fontes