CKTIS / Java
Pattern.matcher — tworzenie obiektu dopasowującego dla wejścia
`Pattern.matcher` tworzy nowy obiekt `Matcher` dla podanego wejścia. Ten sam skompilowany wzorzec można stosować do wielu tekstów, a każde dopasowywanie ma własny stan.
Wersja: Java SE 21
Składnia
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) to metoda instancyjna klasy Pattern z pakietu java.util.regex. Najpierw skompiluj wyrażenie regularne za pomocą Pattern.compile(regex), a potem wywołaj pattern.matcher(input) na otrzymanym wzorcu. Argument, na przykład String, to tekst do sprawdzenia, a nie wyrażenie regularne. Przekazanie null powoduje NullPointerException.
Każde wywołanie zwraca nowy Matcher, ale jeszcze nie rozpoczyna dopasowywania. find() szuka kolejnego pasującego fragmentu, lookingAt() próbuje dopasować wzorzec od początku regionu, a matches() sprawdza cały region. Domyślnie region obejmuje całe wejście. Wszystkie trzy metody zwracają boolean.
Po udanym dopasowaniu group() zwraca cały dopasowany fragment. Wywołanie group() przed pierwszą próbą lub po nieudanej próbie powoduje IllegalStateException. Dlatego w pętli wywołuj group() tylko wtedy, gdy find() zwróci true.
Pattern jest niemutowalny i można go współdzielić między wątkami. Matcher przechowuje zmienny stan dopasowania i nie jest bezpieczny przy współbieżnym użyciu. Twórz osobne obiekty Matcher, gdy potrzebujesz niezależnego stanu. reset() zachowuje wejście, a reset(newInput) je zmienia; obie metody odrzucają poprzedni wynik i przywracają region obejmujący całe wejście.
Przykłady
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern digits = Pattern.compile("[0-9]+");
Matcher scan = digits.matcher("A12 B34");
Matcher whole = digits.matcher("56");
while (scan.find()) {
System.out.println(scan.group());
}
System.out.println(whole.matches());
}
}Wynik
12 34 true
Wzorzec `[0-9]+` dopasowuje co najmniej jedną kolejną cyfrę ASCII. Pierwszy `Matcher` wypisuje `12` i `34`, a drugi, utworzony z tego samego wzorca, wypisuje `true`, bo całe wejście `56` pasuje.
Powiązane lekcje
- Java · Lekcja 70 · Podstawowy · Wersja: 2