CKTIS / Java
Matcher.group() en Matcher.group(int): de hele match en groepen
Lees na een geslaagde regex-match de volledige gematchte tekst of de tekst die een specifieke groep heeft vastgelegd. Groep 0 staat voor de volledige match.
Versie: Java SE 21
Syntax
public String group()
public String group(int group)In Java SE 21 heeft java.util.regex.Matcher drie overloads van group met retourtype String. Hier worden group() en group(int) behandeld; de derde overload, group(String), geeft de tekst terug die een benoemde groep heeft vastgelegd. Matcher.group() geeft het volledige gematchte deel van de invoer terug en is gelijkwaardig aan group(0). Met een index van 1 tot en met groupCount() geeft Matcher.group(int) de tekst terug die de gekozen groep heeft vastgelegd. Groepen die tekst vastleggen, worden van links naar rechts genummerd op basis van hun openingshaakjes. Een niet-vastleggende groep (?:...) krijgt geen nummer, en groupCount() telt groep 0 niet mee.
Lees de groepen nadat matches(), find() of lookingAt() true heeft teruggegeven. matches() controleert het hele huidige invoergebied, find() zoekt het volgende passende deel en lookingAt() controleert of er een match begint aan het begin van het gebied, zonder dat die het hele gebied hoeft te beslaan. De group-methoden voeren zelf geen matchpoging uit. Lees de benodigde waarden vóór de volgende poging of een aanroep van reset().
Als de match geslaagd is maar de gekozen groep er niet aan deelnam, geeft group(int) null terug. Als de groep wel deelnam en nul tekens matchte, krijg je de lege tekenreeks "". Vóór de eerste poging, na een mislukte poging of na reset() zonder nieuwe poging gooien beide overloads IllegalStateException. Bij een geldige matchstatus leidt een index buiten het bereik tot IndexOutOfBoundsException. Een patroonwijziging met usePattern(...) na een geslaagde match wist de groepsgegevens; vóór een volgende poging kunnen beide overloads null teruggeven.
Voorbeelden
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) + "]");
}
}
}Resultaat
group() = [ID-42] group(0) = [ID-42] group(1) = [ID] group(2) = [42] group(3) = null group(4) = []
`find()` vindt `ID-42` in `item: ID-42`. Groep 3 doet niet mee, omdat de optionele letter ontbreekt. Groep 4 matcht nul spaties, dus `[]` toont een lege tekenreeks.
Gerelateerde lessen
- Java · Les 70 · Basis · Versie: 2