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

CKTIS / Java

Matcher.find: procurar correspondências sucessivas

Usa `find()` para procurar correspondências sucessivas de uma expressão regular ou `find(int start)` para reiniciar a pesquisa a partir de um índice da entrada.

Versão: Java SE 21

Sintaxe

public boolean find()
public boolean find(int start)

Matcher.find é um método de instância de java.util.regex.Matcher. Cria um Matcher com pattern.matcher(input). Num objeto novo ou reinicializado, find() começa no início da região, que por omissão abrange toda a entrada. Reutiliza o mesmo objeto em while (matcher.find()): após uma correspondência não vazia, a pesquisa seguinte começa logo a seguir. true indica que foi encontrada uma correspondência, mesmo que seja vazia; false indica que não foi encontrada outra.

Depois de true, usa group() para obter todo o texto encontrado, start() para o início incluído e end() para o fim excluído. Os índices começam em zero e são relativos à entrada completa. Lê o resultado antes de outra tentativa: a API prevê IllegalStateException para estes métodos antes de qualquer tentativa ou após uma tentativa falhada.

find(int start) reinicializa o Matcher, repõe a região de modo a abranger toda a entrada e pesquisa a partir de start. A correspondência não tem de começar exatamente nesse índice. O método lança IndexOutOfBoundsException se start for negativo ou superior ao comprimento da entrada. Para continuares a pesquisa, chama find() sem argumentos; find(int start) reinicia-a em cada chamada.

lookingAt() exige uma correspondência no início da região, mas não em toda a região. matches() exige que toda a região corresponda. find() pesquisa em qualquer posição da região que o padrão permita.

Exemplos

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Matcher matcher = Pattern.compile("[0-9]+").matcher("A12 B7");

        while (matcher.find()) {
            System.out.println(matcher.group() + " [" + matcher.start()
                    + ", " + matcher.end() + ")");
        }

        if (matcher.find(4)) {
            System.out.println("find(4): " + matcher.group());
        }
    }
}

Resultado

12 [1, 3)
7 [5, 6)
find(4): 7

`[0-9]+` corresponde a sequências de um ou mais algarismos ASCII. O ciclo apresenta `12` e `7` com os respetivos intervalos. Depois do ciclo, `find(4)` começa em `B` e encontra `7` no índice `5`.

Lições relacionadas

  • Java · Lição 70 · Básico · Versão: 2

Fontes