CKTIS / Java
Matcher.group() a Matcher.group(int): celá shoda a skupiny
Po úspěšném vyhodnocení regulárního výrazu získej celý odpovídající úsek nebo text zachycený konkrétní skupinou. Skupina 0 označuje celou shodu.
Verze: Java SE 21
Syntaxe
public String group()
public String group(int group)V Java SE 21 nabízí java.util.regex.Matcher tři varianty přetížené metody group s návratovým typem String. Zde jsou popsány group() a group(int); třetí varianta group(String) vrací text zachycený pojmenovanou skupinou. Matcher.group() vrací celý odpovídající úsek vstupu a je ekvivalentní volání group(0). Matcher.group(int) s indexem od 1 do groupCount() vrací text zachycený zvolenou skupinou. Zachytávací skupiny se číslují podle otevíracích závorek zleva doprava. Nezachytávací skupina (?:...) číslo nedostane a groupCount() skupinu 0 nezapočítává.
Skupiny čti, až když matches(), find() nebo lookingAt() vrátí true. matches() ověřuje celou aktuální oblast vstupu, find() hledá další odpovídající úsek a lookingAt() ověřuje, zda shoda začíná na začátku oblasti, aniž by ji musela pokrýt celou. Metody group samy žádnou shodu nehledají. Potřebné hodnoty si přečti před dalším pokusem nebo voláním reset().
Pokud celková shoda uspěla, ale zvolená skupina se jí neúčastnila, group(int) vrátí null. Pokud se skupina účastnila a zachytila nula znaků, vrátí prázdný řetězec "". Před prvním pokusem, po neúspěšném pokusu nebo po reset() bez nového pokusu obě metody vyvolají IllegalStateException. Při platném stavu shody způsobí index mimo rozsah IndexOutOfBoundsException. Změna vzoru pomocí usePattern(...) po úspěšné shodě zahodí údaje o skupinách; před dalším pokusem mohou obě metody vrátit null.
Pří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ýsledek
group() = [ID-42] group(0) = [ID-42] group(1) = [ID] group(2) = [42] group(3) = null group(4) = []
`find()` najde `ID-42` v `item: ID-42`. Skupina 3 se shody neúčastní, protože nepovinné písmeno chybí. Skupina 4 zachytí nula mezer, takže `[]` ukazuje prázdný řetězec.
Související lekce
- Java · Lekce 70 · Základní · Verze: 2