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

CKTIS / Java

Pattern — uma expressão regular compilada

java.util.regex.Pattern guarda uma expressão regular compilada. Pattern.compile cria o padrão e Pattern.matcher cria um Matcher para verificar uma entrada inteira ou procurar subsequências correspondentes.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();

java.util.regex.Pattern representa uma expressão regular compilada. Pattern.compile(regex) cria um padrão e Pattern.matcher(input) cria um Matcher para o texto fornecido. É o Matcher que realiza a correspondência; criar o padrão, por si só, não o faz.

A sintaxe das expressões regulares descreve o texto aceite. Em ID-(\d{3}), ID- é literal, \d significa um algarismo ASCII por predefinição, {3} exige três repetições e os parênteses formam um grupo de captura. Nos literais de cadeia Java, é necessário duplicar as barras invertidas: "ID-(\\d{3})".

matches() verifica toda a região de correspondência, que por predefinição corresponde a toda a entrada. find() procura a próxima subsequência correspondente. Após uma correspondência bem-sucedida, group(1) devolve o texto do primeiro grupo; neste caso, 042, ainda como texto.

Compila uma única vez um padrão que reutilizes. Pattern é imutável e pode ser partilhado com segurança entre threads; Matcher não. Uma sintaxe inválida provoca PatternSyntaxException. Quando o texto deve ser tratado literalmente, e não como sintaxe regex, usa Pattern.quote(text).

Exemplos

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("ID-(\\d{3})");
        System.out.println(pattern.matcher("ID-042").matches());
        System.out.println(pattern.matcher("Order ID-042").matches());

        Matcher matcher = pattern.matcher("Order ID-042");
        if (matcher.find()) {
            System.out.println(matcher.group(1));
        }
    }
}

Resultado

true
false
042

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