WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Matcher — Text prüfen und Treffer auslesen

java.util.regex.Matcher wendet einen regulären Ausdruck auf Text an. matches() prüft den gesamten Bereich, find() sucht nacheinander nach passenden Teilzeichenfolgen und group() liest das Ergebnis eines erfolgreichen Treffers aus.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
    String match = matcher.group();
    // groupCount() counts capturing groups in the pattern, excluding group 0.
    // This guard checks that group 1 exists, not that it participated in the match.
    if (matcher.groupCount() >= 1) {
        String captured = matcher.group(1);
    }
}

java.util.regex.Matcher gleicht ein Pattern mit Text ab. Erstellen Sie ihn mit pattern.matcher(input). Das Objekt speichert den Suchzustand; geben Sie es nicht für die gemeinsame Verwendung durch mehrere Threads frei.

Matcher.matches() prüft den gesamten aktuellen Bereich, der standardmäßig die gesamte Eingabe umfasst. Matcher.find() sucht nach der nächsten passenden Teilzeichenfolge; wiederholte Aufrufe setzen die Suche fort. Beide Methoden geben boolean zurück. reset() verwirft den Trefferzustand und setzt den Bereich wieder auf die gesamte Eingabe.

Matcher.group() und group(0) geben den vollständigen Treffer zurück. Erfassungsgruppen werden in der Reihenfolge ihrer öffnenden Klammern ab 1 nummeriert: group(1) liest die erste Gruppe aus. Eine benannte Gruppe lesen Sie mit group("name") aus. Eine optionale Gruppe, die nicht beteiligt war, gibt null zurück; eine Gruppe, die leeren Text erfasst, gibt "" zurück.

Lesen Sie Gruppen erst nach einem Ergebnis true aus: Vor einem Match-Versuch oder nach einem fehlgeschlagenen Versuch löst group() eine IllegalStateException aus. Im Beispiel gibt matches() false zurück, weil das Muster nicht die gesamte Eingabe abdeckt. Nach reset() liest die find()-Schleife zwei Treffer und ihre Gruppen aus.

Beispiele

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
        Matcher matcher = pattern.matcher("AB-12 CD-7");

        System.out.println("matches=" + matcher.matches());
        matcher.reset();
        while (matcher.find()) {
            System.out.println(matcher.group() + " | "
                    + matcher.group(1) + " | " + matcher.group(2));
        }
    }
}

Ergebnis

matches=false
AB-12 | AB | 12
CD-7 | CD | 7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen