Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Matcher — sprawdzanie tekstu i odczytywanie dopasowań

java.util.regex.Matcher stosuje wyrażenie regularne do tekstu. matches() sprawdza cały region, find() wyszukuje kolejne fragmenty, a group() odczytuje wynik udanego dopasowania.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
    String match = matcher.group();
    // groupCount() counts capturing groups in the pattern, excluding group 0.
    // This guard checks that group 1 exists, not that it participated in the match.
    if (matcher.groupCount() >= 1) {
        String captured = matcher.group(1);
    }
}

java.util.regex.Matcher wykonuje dopasowania wzorca Pattern do tekstu. Utwórz go przez pattern.matcher(input). Obiekt przechowuje stan wyszukiwania; nie współdziel go między wątkami.

Matcher.matches() sprawdza cały bieżący region, domyślnie cały tekst. Matcher.find() szuka następnego pasującego fragmentu; kolejne wywołania przesuwają wyszukiwanie. Obie metody zwracają boolean. reset() usuwa stan dopasowania i przywraca region obejmujący cały tekst.

Matcher.group() oraz group(0) zwracają całe dopasowanie. Grupy przechwytujące są numerowane od 1 według kolejności nawiasów otwierających: group(1) odczytuje pierwszą. Nazwaną grupę odczytasz przez group("name"). Nieuczestnicząca grupa opcjonalna daje null, a grupa dopasowana do pustego tekstu daje "".

Odczytuj grupy po wyniku true: przed próbą dopasowania lub po nieudanej próbie group() zgłasza IllegalStateException. W przykładzie matches() daje false, ponieważ wzorzec nie obejmuje całego tekstu; po reset() pętla find() odczytuje dwa dopasowania i ich grupy.

Przykłady

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
        Matcher matcher = pattern.matcher("AB-12 CD-7");

        System.out.println("matches=" + matcher.matches());
        matcher.reset();
        while (matcher.find()) {
            System.out.println(matcher.group() + " | "
                    + matcher.group(1) + " | " + matcher.group(2));
        }
    }
}

Wynik

matches=false
AB-12 | AB | 12
CD-7 | CD | 7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła