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

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

Fontes