Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła