CKTIS / Java
String.matches: verificar se uma cadeia inteira corresponde a uma expressão regular
Verifica a correspondência da cadeia inteira. Aprende como `(?s)` altera o ponto, que classes de carateres usam ASCII por predefinição e como escrever barras invertidas em literais de Java.
Versão: Java SE 21
Sintaxe
public boolean matches(String regex)String.matches é um método de instância de java.lang.String. A chamada text.matches(regex) interpreta o argumento como uma expressão regular e devolve true apenas se todo o text corresponder, e não apenas uma subcadeia. Não são necessárias as âncoras ^ e $. Para procurar uma subcadeia correspondente, usa Pattern.compile(regex).matcher(text).find().
Coloca (?s) no início do padrão para ativar DOTALL: assim, . também corresponde a carateres de fim de linha, que por predefinição não abrange. Não confundas (?s) com (?m): MULTILINE altera o comportamento das âncoras ^ e $, não o do ponto.
Numa expressão regular, [A-Z] é o intervalo de letras maiúsculas ASCII de A a Z. Por predefinição, \d equivale a [0-9] e \w a [a-zA-Z_0-9]. A opção (?U) (UNICODE_CHARACTER_CLASS) ativa as variantes Unicode destas classes predefinidas, mas não expande o intervalo explícito [A-Z].
Os literais de cadeia Java e as expressões regulares são interpretados separadamente. Escreve "\\d" para passar \d ao motor e "\\." para passar \. e reconhecer um ponto literal. Um padrão inválido lança PatternSyntaxException e um argumento null lança NullPointerException; em nenhum destes casos o método devolve false. Se reutilizares o mesmo padrão, compila-o uma vez com Pattern.compile(regex) e chama pattern.matcher(text).matches() para cada cadeia.
Exemplos
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
String code = "[A-Z]{2}\\.\\d{2}";
String withPrefix = "XAB.42";
String nonAsciiDigits = "AB.\u0664\u0662";
String twoLines = "start\nend";
System.out.println("whole: " + "AB.42".matches(code));
System.out.println("prefixed whole: " + withPrefix.matches(code));
System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
System.out.println("wrong separator: " + "AB-42".matches(code));
System.out.println("default digits: " + nonAsciiDigits.matches(code));
System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
System.out.println("default dot: " + twoLines.matches("start.*end"));
System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
}
}Resultado
whole: true prefixed whole: false prefixed find: true wrong separator: false default digits: false Unicode digits: true default dot: false DOTALL dot: true
`AB.42` corresponde na íntegra, enquanto `find()` encontra uma subcadeia correspondente em `XAB.42`. O hífen não substitui o ponto literal. Os algarismos árabe-índicos só correspondem com `(?U)`, e o ponto só corresponde à quebra de linha com `(?s)`.
Lições relacionadas
- Java · Lição 1 · Intermédio · Versão: 2