Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Matcher.group() a Matcher.group(int): celá zhoda a skupiny

Po úspešnej zhode s regulárnym výrazom získaj celý zhodný úsek alebo text zachytený konkrétnou skupinou. Skupina 0 označuje celú zhodu.

Verzia: Java SE 21

Syntax

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

V Java SE 21 ponúka java.util.regex.Matcher tri varianty preťaženej metódy group s návratovým typom String. Tu sú opísané group() a group(int); tretí variant group(String) vráti text zachytený pomenovanou skupinou. Matcher.group() vráti celý zhodný úsek vstupu a je ekvivalentom volania group(0). Matcher.group(int) s indexom od 1 po groupCount() vráti text zachytený zvolenou skupinou. Zachytávacie skupiny sa číslujú podľa otváracích zátvoriek zľava doprava. Nezachytávacia skupina (?:...) nedostane číslo a groupCount() nezapočítava skupinu 0.

Skupiny čítaj po tom, ako matches(), find() alebo lookingAt() vráti true. matches() kontroluje celú aktuálnu oblasť vstupu, find() hľadá ďalší zhodný úsek a lookingAt() overuje, či zhoda začína na začiatku oblasti, bez toho, aby ju musela pokrývať celú. Metódy group samy zhodu nehľadajú. Potrebné hodnoty si prečítaj pred ďalším pokusom alebo volaním reset().

Ak celková zhoda uspela, ale zvolená skupina sa na nej nepodieľala, group(int) vráti null. Ak sa skupina na zhode podieľala a zachytila nula znakov, vráti prázdny reťazec "". Pred prvým pokusom, po neúspešnom pokuse alebo po reset() bez nového pokusu obe metódy vyhodia IllegalStateException. Pri platnom stave zhody spôsobí index mimo rozsahu IndexOutOfBoundsException. Zmena vzoru cez usePattern(...) po úspešnej zhode zahodí údaje o skupinách; pred ďalším pokusom môžu obe metódy vrátiť null.

Príklady

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

Výsledok

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

`find()` nájde `ID-42` v `item: ID-42`. Skupina 3 sa na zhode nepodieľa, pretože nepovinné písmeno chýba. Skupina 4 zachytí nula medzier, takže `[]` zobrazuje prázdny reťazec.

Súvisiace lekcie

  • Java · Lekcia 70 · Základná · Verzia: 2

Zdroje