Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Matcher.group() i Matcher.group(int): całe dopasowanie i grupy

Po udanym dopasowaniu pobierz cały dopasowany fragment lub tekst wybranej grupy przechwytującej. Grupa 0 oznacza całe dopasowanie.

Wersja: Java SE 21

Składnia

public String group()
public String group(int group)

W Java SE 21 klasa java.util.regex.Matcher udostępnia trzy przeciążenia metody group zwracające String. Tu omówiono group() i group(int); trzecie przeciążenie, group(String), zwraca tekst przechwycony przez grupę o podanej nazwie. Matcher.group() zwraca cały dopasowany fragment tekstu wejściowego i jest równoważne group(0). Matcher.group(int) z indeksem od 1 do groupCount() zwraca tekst przechwycony przez wskazaną grupę. Grupy przechwytujące numeruje się według kolejności ich nawiasów otwierających od lewej do prawej. Grupa nieprzechwytująca (?:...) nie dostaje numeru, a grupa 0 nie wchodzi do wyniku groupCount().

Odczytuj grupy dopiero po tym, jak matches(), find() lub lookingAt() zwróci true. matches() sprawdza cały bieżący obszar wejścia, find() szuka kolejnego pasującego fragmentu, a lookingAt() sprawdza, czy dopasowanie zaczyna się na początku obszaru, bez wymogu objęcia go w całości. Metody group nie uruchamiają dopasowania. Odczytaj potrzebne wartości przed kolejną próbą lub wywołaniem reset().

Jeśli całe dopasowanie się udało, ale wskazana grupa w nim nie uczestniczyła, group(int) zwraca null. Jeśli grupa uczestniczyła i dopasowała zero znaków, zwraca pusty ciąg "". Bez wcześniejszej próby, po nieudanej próbie lub po reset() bez nowej próby oba przeciążenia zgłaszają IllegalStateException. Przy poprawnym stanie dopasowania indeks spoza zakresu zgłasza IndexOutOfBoundsException. Zmiana wzorca przez usePattern(...) po udanym dopasowaniu usuwa dane grup; przed kolejną próbą oba przeciążenia mogą zwrócić null.

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("(ID)-([0-9]+)([A-Z])?([ ]*)");
        Matcher matcher = pattern.matcher("item: ID-42");

        if (matcher.find()) {
            System.out.println("group() = [" + matcher.group() + "]");
            System.out.println("group(0) = [" + matcher.group(0) + "]");
            System.out.println("group(1) = [" + matcher.group(1) + "]");
            System.out.println("group(2) = [" + matcher.group(2) + "]");
            System.out.println("group(3) = " + matcher.group(3));
            System.out.println("group(4) = [" + matcher.group(4) + "]");
        }
    }
}

Wynik

group() = [ID-42]
group(0) = [ID-42]
group(1) = [ID]
group(2) = [42]
group(3) = null
group(4) = []

`find()` znajduje `ID-42` wewnątrz `item: ID-42`. Grupa 3 nie uczestniczy w dopasowaniu, ponieważ nie ma opcjonalnej litery. Grupa 4 dopasowuje zero spacji, więc `[]` pokazuje pusty ciąg.

Powiązane lekcje

  • Java · Lekcja 70 · Podstawowy · Wersja: 2

Źródła