WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Pattern — ein kompiliertes reguläres Muster

java.util.regex.Pattern speichert einen kompilierten regulären Ausdruck. Pattern.compile erstellt das Muster, und Pattern.matcher erzeugt einen Matcher, um eine vollständige Eingabe zu prüfen oder passende Teilfolgen zu suchen.

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

Syntax

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();

java.util.regex.Pattern stellt einen kompilierten regulären Ausdruck dar. Pattern.compile(regex) erstellt ein Muster, und Pattern.matcher(input) erzeugt einen Matcher für den angegebenen Text. Das Matching führt der Matcher aus; das Erstellen des Musters allein reicht nicht aus.

Die Syntax regulärer Ausdrücke beschreibt zulässigen Text. In ID-(\d{3}) ist ID- wörtlich, \d steht standardmäßig für eine ASCII-Ziffer, {3} verlangt drei Wiederholungen, und die Klammern bilden eine erfassende Gruppe. In Java-Stringliteralen müssen umgekehrte Schrägstriche verdoppelt werden: "ID-(\\d{3})".

matches() prüft den gesamten Matching-Bereich, der standardmäßig der gesamten Eingabe entspricht. find() sucht nach der nächsten passenden Teilfolge. Nach einem erfolgreichen Treffer gibt group(1) den Text der ersten Gruppe zurück; hier ist das 042, weiterhin als Text.

Kompiliere ein wiederverwendetes Muster nur einmal. Pattern ist unveränderlich und kann sicher zwischen Threads geteilt werden; Matcher ist es nicht. Ungültige Syntax führt zu PatternSyntaxException. Wenn Text wörtlich statt als Regex-Syntax behandelt werden soll, verwende Pattern.quote(text).

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-(\\d{3})");
        System.out.println(pattern.matcher("ID-042").matches());
        System.out.println(pattern.matcher("Order ID-042").matches());

        Matcher matcher = pattern.matcher("Order ID-042");
        if (matcher.find()) {
            System.out.println(matcher.group(1));
        }
    }
}

Ergebnis

true
false
042

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