CKTIS / Java
`Matcher.matches()`: dopasowanie całego regionu w Javie
`Matcher.matches()` sprawdza, czy wyrażenie regularne pasuje do całego bieżącego regionu, a nie tylko do jego fragmentu. Domyślnie region obejmuje całe wejście.
Wersja: Java SE 21
Składnia
public boolean matches()Matcher.matches() to bezargumentowa metoda instancji klasy java.util.regex.Matcher. Skompiluj wyrażenie regularne za pomocą Pattern.compile(regex), utwórz obiekt Matcher przez pattern.matcher(input) i wywołaj matcher.matches(). Metoda zwraca true tylko wtedy, gdy wzorzec pasuje do całego bieżącego regionu; w przeciwnym razie zwraca false.
Domyślnie region obejmuje całe wejście. Metoda region(start, end) ustawia jego granice: indeks start jest włączony, a end wyłączony. Po ich ustawieniu matches() wymaga dopasowania całego wybranego regionu, nie całego pierwotnego wejścia. Nie trzeba dodawać kotwic ^ i $ tylko po to, by wymusić dopasowanie całego regionu.
Jeśli wystarczy dopasowanie od początku regionu, użyj lookingAt(); jeśli chcesz wyszukać następny pasujący fragment w regionie, użyj find(). Po tym, jak matches() zwróci true, group() zwraca dopasowany tekst, a start() i end() zwracają jego indeksy w wejściu: początkowy włącznie i końcowy wyłącznie. Po wyniku false te trzy metody zgłaszają IllegalStateException, jeśli wywołasz je przed kolejnym udanym dopasowaniem.
Przykłady
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern fourDigits = Pattern.compile("[0-9]{4}");
String input = "id=1234!";
System.out.println(fourDigits.matcher(input).matches());
System.out.println(fourDigits.matcher(input).find());
System.out.println(fourDigits.matcher("1234!").lookingAt());
Matcher selected = fourDigits.matcher(input).region(3, 7);
boolean matched = selected.matches();
System.out.println(matched);
if (matched) {
System.out.println(selected.group());
}
}
}Wynik
false true true true 1234
Wzorzec `[0-9]{4}` wymaga dokładnie czterech cyfr ASCII. Całe `id=1234!` nie pasuje, ale `find()` znajduje `1234`. Dla `1234!` metoda `lookingAt()` dopasowuje początek. Region `[3, 7)` w `id=1234!` zawiera tylko `1234`, więc `matches()` zwraca `true`, a `group()` zwraca `1234`.
Powiązane lekcje
- Java · Lekcja 70 · Podstawowy · Wersja: 2