WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.matches: eine gesamte Zeichenfolge mit einem regulären Ausdruck abgleichen

Prüfe, ob eine gesamte Zeichenfolge zu einem regulären Ausdruck passt. Erfahre, wie `(?s)` den Punkt verändert, welche Zeichenklassen standardmäßig ASCII verwenden und wie Backslashes in Java-Stringliteralen geschrieben werden.

Version: Java SE 21

Syntax

public boolean matches(String regex)

String.matches ist eine Instanzmethode von java.lang.String. Der Aufruf text.matches(regex) interpretiert das Argument als regulären Ausdruck und liefert nur dann true, wenn der gesamte text passt, nicht nur ein Teil davon. Die Anker ^ und $ sind dafür nicht nötig. Suche nach einer passenden Teilzeichenfolge mit Pattern.compile(regex).matcher(text).find().

Setze (?s) an den Anfang des Musters, um DOTALL zu aktivieren: Dann erfasst . auch Zeilenumbruchzeichen. Standardmäßig erfasst der Punkt sie nicht. Verwechsle (?s) nicht mit (?m): MULTILINE ändert das Verhalten der Anker ^ und $, nicht das des Punkts.

Im regulären Ausdruck steht [A-Z] für den Bereich der ASCII-Großbuchstaben von A bis Z. Standardmäßig bedeutet \d dasselbe wie [0-9] und \w dasselbe wie [a-zA-Z_0-9]. Das Flag (?U) (UNICODE_CHARACTER_CLASS) aktiviert Unicode-Varianten dieser vordefinierten Klassen, erweitert aber nicht den expliziten Bereich [A-Z].

Java-Stringliterale und reguläre Ausdrücke werden getrennt interpretiert. Schreibe "\\d", damit die Regex-Engine \d erhält, und "\\.", damit sie \. erhält und einen wörtlichen Punkt abgleicht. Ein ungültiges Muster löst PatternSyntaxException aus, ein null-Argument NullPointerException; in keinem der beiden Fälle wird false zurückgegeben. Kompiliere ein mehrfach verwendetes Muster einmal mit Pattern.compile(regex) und rufe für jede Zeichenfolge pattern.matcher(text).matches() auf.

Beispiele

import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        String code = "[A-Z]{2}\\.\\d{2}";
        String withPrefix = "XAB.42";
        String nonAsciiDigits = "AB.\u0664\u0662";
        String twoLines = "start\nend";

        System.out.println("whole: " + "AB.42".matches(code));
        System.out.println("prefixed whole: " + withPrefix.matches(code));
        System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
        System.out.println("wrong separator: " + "AB-42".matches(code));
        System.out.println("default digits: " + nonAsciiDigits.matches(code));
        System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
        System.out.println("default dot: " + twoLines.matches("start.*end"));
        System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
    }
}

Ergebnis

whole: true
prefixed whole: false
prefixed find: true
wrong separator: false
default digits: false
Unicode digits: true
default dot: false
DOTALL dot: true

`AB.42` passt vollständig; in `XAB.42` findet `find()` nur eine passende Teilzeichenfolge. Der Bindestrich ersetzt den wörtlichen Punkt nicht. Die arabisch-indischen Ziffern passen nur mit `(?U)`, und der Punkt erfasst den Zeilenumbruch nur mit `(?s)`.

Zugehörige Lektionen

  • Java · Lektion 1 · Mittlere Stufe · Version: 2

Quellen