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