CKTIS / Java
`Matcher.matches()`: Den gesamten Bereich in Java abgleichen
`Matcher.matches()` prüft, ob ein regulärer Ausdruck auf den gesamten aktuellen Bereich passt und nicht nur auf einen Teil davon. Standardmäßig umfasst der Bereich die gesamte Eingabe.
Version: Java SE 21
Syntax
public boolean matches()Matcher.matches() ist eine parameterlose Instanzmethode von java.util.regex.Matcher. Kompiliere den regulären Ausdruck mit Pattern.compile(regex), erzeuge mit pattern.matcher(input) einen Matcher und rufe matcher.matches() auf. Die Methode gibt nur dann true zurück, wenn das Muster auf den gesamten aktuellen Bereich passt; sonst gibt sie false zurück.
Standardmäßig umfasst der Bereich die ganze Eingabe. Mit region(start, end) legst du seine Grenzen fest: start ist einschließlich, end ausschließlich. Danach muss das Muster bei matches() auf den gesamten ausgewählten Bereich passen, nicht auf die gesamte ursprüngliche Eingabe. Du musst nicht eigens ^ und $ hinzufügen, um einen vollständigen Abgleich des Bereichs zu verlangen.
Verwende lookingAt(), wenn ein Treffer am Anfang des Bereichs genügt, oder find(), um die nächste passende Teilsequenz im Bereich zu suchen. Gibt matches() den Wert true zurück, liefert group() den gefundenen Text; start() und end() liefern den inklusiven Startindex und den exklusiven Endindex in der Eingabe. Nach false lösen diese drei Methoden bis zum nächsten erfolgreichen Abgleich eine IllegalStateException aus.
Beispiele
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern fourDigits = Pattern.compile("[0-9]{4}");
String input = "id=1234!";
System.out.println(fourDigits.matcher(input).matches());
System.out.println(fourDigits.matcher(input).find());
System.out.println(fourDigits.matcher("1234!").lookingAt());
Matcher selected = fourDigits.matcher(input).region(3, 7);
boolean matched = selected.matches();
System.out.println(matched);
if (matched) {
System.out.println(selected.group());
}
}
}Ergebnis
false true true true 1234
Das Muster `[0-9]{4}` verlangt genau vier ASCII-Ziffern. `id=1234!` passt als Ganzes nicht, aber `find()` findet `1234`. Bei `1234!` passt das Muster mit `lookingAt()` auf den Anfang. Der Bereich `[3, 7)` von `id=1234!` enthält nur `1234`, deshalb gibt `matches()` den Wert `true` und `group()` den Text `1234` zurück.
Zugehörige Lektionen
- Java · Lektion 70 · Grundlagen · Version: 2