CKTIS / Java
Matcher.group() in Matcher.group(int): celotno ujemanje in skupine
Po uspešnem ujemanju preberi celotno ujemajoče se besedilo ali le besedilo, ki ga je zajela izbrana skupina. Skupina 0 predstavlja celotno ujemanje.
Različica: Java SE 21
Sintaksa
public String group()
public String group(int group)V Java SE 21 ima razred java.util.regex.Matcher tri preobremenjene različice metode group, ki vrnejo String. Tu sta opisani group() in group(int); tretja različica, group(String), vrne besedilo, ki ga je zajela poimenovana skupina. Matcher.group() vrne celotni ujemajoči se del vhoda in je enakovreden klicu group(0). Matcher.group(int) z indeksom od 1 do groupCount() vrne besedilo, ki ga je zajela izbrana skupina. Zajemne skupine so oštevilčene po začetnih oklepajih od leve proti desni. Nezajemna skupina (?:...) ne dobi številke, groupCount() pa ne šteje skupine 0.
Skupine preberi, ko matches(), find() ali lookingAt() vrne true. matches() preveri celotno trenutno območje vhoda, find() poišče naslednji ujemajoči se del, lookingAt() pa preveri, ali se ujemanje začne na začetku območja, ne da bi moralo zajeti celotno območje. Metodi group ne iščeta ujemanj. Potrebne vrednosti preberi pred naslednjim poskusom ali klicem reset().
Če je celotno ujemanje uspelo, izbrana skupina pa pri njem ni sodelovala, group(int) vrne null. Če je skupina sodelovala in zajela nič znakov, vrne prazen niz "". Pred prvim poskusom, po neuspelem poskusu ali po reset() brez novega poskusa obe metodi sprožita IllegalStateException. Ob veljavnem stanju ujemanja indeks zunaj dovoljenega obsega sproži IndexOutOfBoundsException. Sprememba vzorca z usePattern(...) po uspešnem ujemanju zavrže podatke o skupinah; do naslednjega poskusa lahko obe metodi vrneta null.
Primeri
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()` najde `ID-42` v `item: ID-42`. Skupina 3 pri ujemanju ne sodeluje, ker neobvezne črke ni. Skupina 4 zajame nič presledkov, zato `[]` prikazuje prazen niz.
Povezane lekcije
- Java · Lekcija 70 · Osnovna · Različica: 2