CKTIS / Java
Matcher.find: hledání dalších shod
Pomocí `find()` vyhledáš postupně jednotlivé shody s regulárním výrazem. Pomocí `find(int start)` spustíš nové hledání od zadaného indexu vstupu.
Verze: Java SE 21
Syntaxe
public boolean find()
public boolean find(int start)Matcher.find je instanční metoda třídy java.util.regex.Matcher. Objekt Matcher vytvoříš pomocí pattern.matcher(input). U nového nebo resetovaného objektu začne find() na začátku prohledávané oblasti, která ve výchozím nastavení zahrnuje celý vstup. V cyklu while (matcher.find()) používej tentýž objekt: po neprázdné shodě začne další hledání hned za ní. true znamená, že byla nalezena shoda, třeba i prázdná; false znamená, že se další shoda nenašla.
Po návratu true získáš pomocí group() celý nalezený text, pomocí start() začátek včetně a pomocí end() konec bez zahrnutí koncové pozice. Indexy začínají nulou a vztahují se k celému vstupu. Výsledek přečti před dalším pokusem: podle API tyto metody vyvolají IllegalStateException, pokud ještě neproběhl žádný pokus nebo pokud předchozí pokus selhal.
find(int start) resetuje objekt Matcher, nastaví prohledávanou oblast zpět na celý vstup a hledá od indexu start. Shoda nemusí začínat přesně na tomto indexu. Pokud je start záporné nebo větší než délka vstupu, metoda vyvolá IndexOutOfBoundsException. Chceš-li v hledání pokračovat, volej find() bez argumentu; find(int start) pokaždé začne hledat znovu.
lookingAt() vyžaduje shodu na začátku oblasti, nemusí ale pokrývat celou oblast. matches() vyžaduje shodu celé oblasti. find() hledá na libovolném místě v oblasti, které vzor připouští.
Příklady
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());
}
}
}Výsledek
12 [1, 3) 7 [5, 6) find(4): 7
`[0-9]+` odpovídá posloupnosti jedné nebo více číslic ASCII. Cyklus vypíše `12` a `7` s jejich intervaly. Po skončení cyklu začne `find(4)` u `B` a najde `7` na indexu `5`.
Související lekce
- Java · Lekce 70 · Základní · Verze: 2