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

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

Fontes