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

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.

Fontes