WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Matcher.group() und Matcher.group(int): gesamter Treffer und Gruppen

Nach einem erfolgreichen Regex-Abgleich kannst du den gesamten Treffer oder den Text einer bestimmten Erfassungsgruppe abrufen. Gruppe 0 steht für den gesamten Treffer.

Version: Java SE 21

Syntax

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

In Java SE 21 bietet java.util.regex.Matcher drei Überladungen von group mit dem Rückgabetyp String. Hier geht es um group() und group(int); die dritte Überladung group(String) liefert den Text einer benannten Erfassungsgruppe. Matcher.group() liefert den gesamten passenden Teil der Eingabe und ist gleichbedeutend mit group(0). Matcher.group(int) liefert für einen Index von 1 bis groupCount() den Text der gewählten Erfassungsgruppe. Die Gruppen werden nach ihren öffnenden Klammern von links nach rechts nummeriert. Eine nicht erfassende Gruppe (?:...) erhält keine Nummer, und Gruppe 0 wird von groupCount() nicht mitgezählt.

Lies die Gruppen aus, nachdem matches(), find() oder lookingAt() den Wert true geliefert hat. matches() prüft den gesamten aktuellen Eingabebereich, find() sucht den nächsten passenden Teil, und lookingAt() prüft auf einen Treffer am Anfang des Bereichs, der nicht den ganzen Bereich abdecken muss. Die group-Methoden führen keinen Abgleich aus. Lies die benötigten Werte vor dem nächsten Versuch oder einem Aufruf von reset() aus.

War der Abgleich erfolgreich, aber die gewählte Gruppe nicht beteiligt, liefert group(int) den Wert null. War die Gruppe beteiligt und erfasste null Zeichen, ist das Ergebnis die leere Zeichenfolge "". Vor dem ersten Versuch, nach einem fehlgeschlagenen Versuch oder nach reset() ohne neuen Versuch werfen beide Überladungen IllegalStateException. Bei gültigem Trefferzustand führt ein Index außerhalb des gültigen Bereichs zu IndexOutOfBoundsException. Ein Musterwechsel mit usePattern(...) nach einem Treffer verwirft die Gruppendaten; vor dem nächsten Versuch können beide Überladungen null liefern.

Beispiele

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

Ergebnis

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

`find()` findet `ID-42` in `item: ID-42`. Gruppe 3 ist nicht beteiligt, da der optionale Buchstabe fehlt. Gruppe 4 erfasst null Leerzeichen; `[]` zeigt daher eine leere Zeichenfolge.

Zugehörige Lektionen

  • Java · Lektion 70 · Grundlagen · Version: 2

Quellen