Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Matcher.group() i Matcher.group(int): cijelo podudaranje i grupe

Nakon uspješnog podudaranja pročitaj cijeli podudarni tekst ili samo tekst koji je uhvatila određena grupa. Grupa 0 predstavlja cijelo podudaranje.

Verzija: Java SE 21

Sintaksa

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

U izdanju Java SE 21 klasa java.util.regex.Matcher ima tri preopterećene inačice metode group koje vraćaju String. Ovdje su opisane group() i group(int); treća inačica, group(String), vraća tekst koji je uhvatila imenovana grupa. Matcher.group() vraća cijeli podudarni dio ulaza i istovjetan je pozivu group(0). Matcher.group(int) s indeksom od 1 do groupCount() vraća tekst koji je uhvatila odabrana grupa. Grupe za hvatanje numeriraju se prema otvarajućim zagradama slijeva nadesno. Grupa bez hvatanja (?:...) ne dobiva broj, a groupCount() ne broji grupu 0.

Grupe pročitaj nakon što matches(), find() ili lookingAt() vrati true. matches() provjerava cijelo trenutačno područje ulaza, find() traži sljedeći podudarni dio, a lookingAt() provjerava počinje li podudaranje na početku područja bez zahtjeva da ga obuhvati u cijelosti. Metode group ne traže podudaranja. Potrebne vrijednosti pročitaj prije sljedećeg pokušaja ili poziva reset().

Ako je podudaranje uspjelo, ali odabrana grupa u njemu nije sudjelovala, group(int) vraća null. Ako je grupa sudjelovala i uhvatila nula znakova, vraća prazan niz "". Prije prvog pokušaja, nakon neuspjelog pokušaja ili nakon reset() bez novog pokušaja obje metode bacaju IllegalStateException. Uz valjano stanje podudaranja indeks izvan dopuštenog raspona izaziva IndexOutOfBoundsException. Promjena uzorka s usePattern(...) nakon uspješnog podudaranja odbacuje podatke o grupama; prije sljedećeg pokušaja obje metode mogu vratiti null.

Primjeri

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) + "]");
        }
    }
}

Rezultat

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

`find()` pronalazi `ID-42` u `item: ID-42`. Grupa 3 ne sudjeluje jer neobaveznog slova nema. Grupa 4 hvata nula razmaka, pa `[]` prikazuje prazan niz znakova.

Povezane lekcije

  • Java · Lekcija 70 · Osnovno · Verzija: 2

Izvori