Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje