CKTIS / Java
Matcher.find: wyszukiwanie kolejnych dopasowań
Użyj `find()`, aby wyszukiwać kolejne fragmenty pasujące do wyrażenia regularnego, lub `find(int start)`, aby rozpocząć nowe wyszukiwanie od podanego indeksu.
Wersja: Java SE 21
Składnia
public boolean find()
public boolean find(int start)Matcher.find to metoda instancji klasy java.util.regex.Matcher. Utwórz obiekt Matcher za pomocą pattern.matcher(input). Pierwsze wywołanie find() na nowym lub zresetowanym obiekcie szuka od początku regionu, który domyślnie obejmuje całe wejście. W pętli while (matcher.find()) używaj tego samego obiektu: po niepustym dopasowaniu kolejne wyszukiwanie rusza tuż za nim. true oznacza, że znaleziono dopasowanie, które może być puste; false oznacza, że nie znaleziono kolejnego.
Po true odczytaj całe dopasowanie przez group(), a jego granice przez start() (włącznie) i end() (wyłącznie). Indeksy są liczone od zera względem całego wejścia. Odczytaj wynik przed kolejną próbą: bez wcześniejszego dopasowania lub po nieudanej próbie API przewiduje dla tych metod IllegalStateException.
find(int start) resetuje obiekt Matcher, przywraca region obejmujący całe wejście i szuka od indeksu start lub dalej. Nie wymaga dopasowania dokładnie pod tym indeksem. Zgłasza IndexOutOfBoundsException, gdy start jest mniejsze od zera lub większe od długości wejścia. Aby kontynuować wyszukiwanie, wywołuj find() bez argumentu; find(int start) za każdym razem zaczyna od nowa.
lookingAt() wymaga dopasowania od początku regionu, ale nie w całym regionie. matches() wymaga dopasowania całego regionu. find() służy do wyszukiwania fragmentów w dowolnym miejscu regionu, na jakie pozwala wzorzec.
Przykłady
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Matcher matcher = Pattern.compile("[0-9]+").matcher("A12 B7");
while (matcher.find()) {
System.out.println(matcher.group() + " [" + matcher.start()
+ ", " + matcher.end() + ")");
}
if (matcher.find(4)) {
System.out.println("find(4): " + matcher.group());
}
}
}Wynik
12 [1, 3) 7 [5, 6) find(4): 7
`[0-9]+` dopasowuje ciągi złożone z co najmniej jednej cyfry ASCII. Pętla wypisuje `12` i `7` wraz z ich przedziałami. Po pętli `find(4)` zaczyna od `B` i znajduje `7` pod indeksem `5`.
Powiązane lekcje
- Java · Lekcja 70 · Podstawowy · Wersja: 2