CKTIS / Java
Pattern — skompilowane wyrażenie regularne
java.util.regex.Pattern przechowuje skompilowane wyrażenie regularne. Pattern.compile tworzy wzorzec, a Pattern.matcher tworzy obiekt Matcher do sprawdzania całego tekstu lub wyszukiwania pasujących fragmentów.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();java.util.regex.Pattern reprezentuje skompilowane wyrażenie regularne. Pattern.compile(regex) tworzy wzorzec, a Pattern.matcher(input) tworzy obiekt Matcher dla podanego tekstu. Dopasowanie wykonuje Matcher, nie samo utworzenie wzorca.
Składnia wyrażeń regularnych (regular expression syntax) opisuje dopuszczalny tekst. W ID-(\d{3}) fragment ID- jest dosłowny, \d oznacza domyślnie cyfrę ASCII, {3} wymaga trzech powtórzeń, a nawiasy tworzą grupę przechwytującą. W literałach Java trzeba podwajać ukośniki odwrotne: "ID-(\\d{3})".
matches() sprawdza cały region dopasowania, domyślnie cały tekst. find() szuka następnego pasującego fragmentu. Po udanym dopasowaniu group(1) zwraca tekst pierwszej grupy; tutaj jest to 042, nadal jako tekst.
Kompiluj ponownie używany wzorzec raz. Pattern jest niemutowalny i bezpieczny do współdzielenia między wątkami; Matcher nie jest. Niepoprawna składnia powoduje PatternSyntaxException. Gdy tekst ma być traktowany dosłownie zamiast jako regex, użyj Pattern.quote(text).
Przykłady
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));
}
}
}Wynik
true false 042
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.