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.