Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła