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