CKTIS / Java
`Matcher.matches()`: verificar toda a região em Java
`Matcher.matches()` verifica se uma expressão regular corresponde a toda a região atual, e não apenas a um excerto. Por predefinição, a região abrange toda a entrada.
Versão: Java SE 21
Sintaxe
public boolean matches()Matcher.matches() é um método de instância sem argumentos de java.util.regex.Matcher. Compila a expressão regular com Pattern.compile(regex), cria um Matcher com pattern.matcher(input) e chama matcher.matches(). O método devolve true apenas se o padrão corresponder a toda a região atual; caso contrário, devolve false.
Por predefinição, a região abrange toda a entrada. Usa region(start, end) para definir os limites: start é inclusivo e end é exclusivo. Depois de definidos os limites, matches() exige uma correspondência para toda a região selecionada, não para toda a entrada original. Não é preciso acrescentar ^ e $ só para exigir uma correspondência em toda a região.
Usa lookingAt() se bastar uma correspondência no início da região ou find() para procurar o próximo excerto correspondente na região. Se matches() devolver true, group() devolve o texto correspondente, e start() e end() dão os respetivos índices na entrada: início inclusivo e fim exclusivo. Após false, estes três métodos lançam IllegalStateException se forem chamados antes de uma nova correspondência bem-sucedida.
Exemplos
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern fourDigits = Pattern.compile("[0-9]{4}");
String input = "id=1234!";
System.out.println(fourDigits.matcher(input).matches());
System.out.println(fourDigits.matcher(input).find());
System.out.println(fourDigits.matcher("1234!").lookingAt());
Matcher selected = fourDigits.matcher(input).region(3, 7);
boolean matched = selected.matches();
System.out.println(matched);
if (matched) {
System.out.println(selected.group());
}
}
}Resultado
false true true true 1234
O padrão `[0-9]{4}` exige exatamente quatro algarismos ASCII. `id=1234!` não corresponde na íntegra, mas `find()` encontra `1234`. Em `1234!`, `lookingAt()` encontra uma correspondência no início. A região `[3, 7)` de `id=1234!` contém apenas `1234`, pelo que `matches()` devolve `true` e `group()` devolve `1234`.
Lições relacionadas
- Java · Lição 70 · Básico · Versão: 2