CKTIS / Java
Matcher — verificar texto e ler correspondências
java.util.regex.Matcher aplica uma expressão regular ao texto. matches() verifica toda a região, find() procura substrings sucessivas e group() lê o resultado de uma correspondência bem-sucedida.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
String match = matcher.group();
// groupCount() counts capturing groups in the pattern, excluding group 0.
// This guard checks that group 1 exists, not that it participated in the match.
if (matcher.groupCount() >= 1) {
String captured = matcher.group(1);
}
}java.util.regex.Matcher compara um Pattern com texto. Crie-o com pattern.matcher(input). O objeto mantém o estado da pesquisa; não o partilhe entre várias threads.
Matcher.matches() verifica toda a região atual, que por predefinição corresponde à totalidade da entrada. Matcher.find() procura a próxima substring correspondente; chamadas sucessivas fazem avançar a pesquisa. Ambos os métodos devolvem boolean. reset() elimina o estado da correspondência e repõe a região para abranger toda a entrada.
Matcher.group() e group(0) devolvem a correspondência completa. Os grupos de captura são numerados a partir de 1, pela ordem dos parênteses de abertura: group(1) lê o primeiro. Leia um grupo com nome através de group("name"). Um grupo opcional que não tenha participado devolve null, enquanto um grupo que corresponda a texto vazio devolve "".
Leia os grupos depois de obter true: antes de uma tentativa de correspondência ou após uma tentativa falhada, group() lança uma IllegalStateException. No exemplo, matches() devolve false porque o padrão não abrange toda a entrada. Depois de reset(), o ciclo find() lê duas correspondências e os respetivos grupos.
Exemplos
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
Matcher matcher = pattern.matcher("AB-12 CD-7");
System.out.println("matches=" + matcher.matches());
matcher.reset();
while (matcher.find()) {
System.out.println(matcher.group() + " | "
+ matcher.group(1) + " | " + matcher.group(2));
}
}
}Resultado
matches=false AB-12 | AB | 12 CD-7 | CD | 7
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.