WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Pattern.compile — reguläre Ausdrücke kompilieren

Kompiliere einen regulären Ausdruck zu einem `Pattern`-Objekt und verwende dasselbe Muster, um mehrere Eingaben zu prüfen.

Version: Java SE 21

Syntax

import java.util.regex.Pattern;

// Static method signatures in java.util.regex.Pattern:
public static Pattern compile(String regex)
public static Pattern compile(String regex, int flags)

In Java SE 21 ist Pattern.compile eine statische Methode der Klasse java.util.regex.Pattern. Sie nimmt einen regulären Ausdruck als String entgegen und gibt ein kompiliertes Pattern zurück. Beim Kompilieren wird noch kein Eingabetext geprüft.

Pattern.compile(regex) hat kein separates Argument für Flags. Der Ausdruck kann aber ein eingebettetes Flag wie (?i) enthalten. Die Überladung Pattern.compile(regex, flags) nimmt eine Bitmaske vom Typ int entgegen. Mit | lassen sich Flags kombinieren, etwa Pattern.CASE_INSENSITIVE | Pattern.UNICODE_CASE, um Groß- und Kleinschreibung nach Unicode-Regeln zu ignorieren.

Eine ungültige Regex-Syntax löst beim Kompilieren des Musters die ungeprüfte Ausnahme PatternSyntaxException aus. Die Überladung mit Flags löst IllegalArgumentException aus, wenn in der Maske Bits gesetzt sind, die keinem definierten Flag entsprechen.

pattern.matcher(input) erstellt einen Matcher für die Eingabe. Dessen Methode matches() prüft den gesamten aktuellen Bereich, der standardmäßig die ganze Eingabe umfasst. find() sucht dagegen nach einer passenden Teilzeichenfolge. Verwende für wiederholte Prüfungen dasselbe unveränderliche Pattern; es kann von mehreren Threads gemeinsam genutzt werden. Ein Matcher speichert den Zustand der Suche und ist nicht threadsicher.

Beispiele

import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern[] patterns = {
            Pattern.compile("[A-Z]{2}[0-9]{2}"),
            Pattern.compile("[0-9]+"),
            Pattern.compile("[A-Z]+"),
            Pattern.compile("[A-Z0-9]+"),
            Pattern.compile("AB.*")
        };

        System.out.println("Pattern | AB12 | 123");
        for (Pattern pattern : patterns) {
            System.out.println(pattern.pattern() + " | "
                    + pattern.matcher("AB12").matches() + " | "
                    + pattern.matcher("123").matches());
        }
    }
}

Ergebnis

Pattern | AB12 | 123
[A-Z]{2}[0-9]{2} | true | false
[0-9]+ | false | true
[A-Z]+ | false | false
[A-Z0-9]+ | true | true
AB.* | true | false

Das Programm kompiliert fünf Muster ohne Flags und prüft jedes davon mit `AB12` und `123`. `[A-Z]+` passt nicht zu `AB12`: Die Buchstaben `AB` passen zwar zum Muster, aber `matches()` verlangt, dass die gesamte Eingabe passt.

Zugehörige Lektionen

  • Java · Lektion 70 · Grundlagen · Version: 2

Quellen