Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Pattern.compile — kompilowanie wyrażeń regularnych

Skompiluj wyrażenie regularne do obiektu `Pattern`, a następnie użyj tego samego wzorca do sprawdzenia kilku tekstów wejściowych.

Wersja: Java SE 21

Składnia

import java.util.regex.Pattern;

// Static method signatures in java.util.regex.Pattern:
public static Pattern compile(String regex)
public static Pattern compile(String regex, int flags)

W Java SE 21 Pattern.compile jest metodą statyczną klasy java.util.regex.Pattern. Przyjmuje wyrażenie regularne jako String i zwraca skompilowany obiekt Pattern. Sama kompilacja nie sprawdza żadnego tekstu wejściowego.

Pattern.compile(regex) nie przyjmuje osobnego argumentu z flagami, ale wyrażenie może zawierać flagę wbudowaną, np. (?i). Przeciążenie Pattern.compile(regex, flags) przyjmuje maskę bitową typu int: flagi można łączyć operatorem |, np. Pattern.CASE_INSENSITIVE | Pattern.UNICODE_CASE, aby ignorować wielkość liter zgodnie z regułami Unicode.

Niepoprawna składnia wyrażenia powoduje zgłoszenie niekontrolowanego wyjątku PatternSyntaxException już podczas kompilacji wzorca. Przeciążenie z flagami zgłasza IllegalArgumentException, jeśli w masce ustawiono bity nieodpowiadające żadnej z definiowanych flag.

pattern.matcher(input) tworzy obiekt Matcher dla podanego wejścia. Jego metoda matches() sprawdza całą bieżącą część wejścia wyznaczoną przez region, domyślnie całe wejście. find() szuka pasującego fragmentu. Przy sprawdzaniu wielu tekstów używaj ponownie niemutowalnego obiektu Pattern, który można współdzielić między wątkami. Obiekt Matcher przechowuje stan dopasowania i nie jest bezpieczny przy współbieżnym użyciu.

Przykłady

import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern[] patterns = {
            Pattern.compile("[A-Z]{2}[0-9]{2}"),
            Pattern.compile("[0-9]+"),
            Pattern.compile("[A-Z]+"),
            Pattern.compile("[A-Z0-9]+"),
            Pattern.compile("AB.*")
        };

        System.out.println("Pattern | AB12 | 123");
        for (Pattern pattern : patterns) {
            System.out.println(pattern.pattern() + " | "
                    + pattern.matcher("AB12").matches() + " | "
                    + pattern.matcher("123").matches());
        }
    }
}

Wynik

Pattern | AB12 | 123
[A-Z]{2}[0-9]{2} | true | false
[0-9]+ | false | true
[A-Z]+ | false | false
[A-Z0-9]+ | true | true
AB.* | true | false

Program kompiluje pięć wzorców bez flag i sprawdza każdy z nich na tekstach `AB12` oraz `123`. Wzorzec `[A-Z]+` nie pasuje do `AB12`: litery `AB` pasują, ale `matches()` wymaga dopasowania całego tekstu.

Powiązane lekcje

  • Java · Lekcja 70 · Podstawowy · Wersja: 2

Źródła