CKTIS / Java
Matcher.find: aufeinanderfolgende Treffer suchen
Mit `find()` suchst du nacheinander nach Treffern eines regulären Ausdrucks. Mit `find(int start)` beginnst du die Suche an einem bestimmten Eingabeindex neu.
Version: Java SE 21
Syntax
public boolean find()
public boolean find(int start)Matcher.find ist eine Instanzmethode von java.util.regex.Matcher. Erzeuge einen Matcher mit pattern.matcher(input). Bei einem neuen oder zurückgesetzten Matcher beginnt find() am Anfang des Suchbereichs, der standardmäßig die gesamte Eingabe umfasst. Verwende in while (matcher.find()) denselben Matcher: Nach einem nicht leeren Treffer beginnt die nächste Suche direkt dahinter. true bedeutet, dass ein Treffer vorliegt, auch wenn er leer ist; false bedeutet, dass kein weiterer Treffer gefunden wurde.
Nach true liefert group() den gesamten Treffer, start() seinen Anfang (inklusiv) und end() sein Ende (exklusiv). Die Indizes beginnen bei null und beziehen sich auf die gesamte Eingabe. Lies das Ergebnis vor dem nächsten Versuch aus: Vor dem ersten Versuch oder nach einem fehlgeschlagenen Versuch sieht die API für diese Methoden eine IllegalStateException vor.
find(int start) setzt den Matcher zurück, stellt die gesamte Eingabe als Suchbereich wieder her und sucht ab start. Der Treffer muss nicht genau an diesem Index beginnen. Ist start negativ oder größer als die Eingabelänge, wird eine IndexOutOfBoundsException ausgelöst. Verwende zum Weitersuchen find() ohne Argument; find(int start) beginnt die Suche jedes Mal neu.
lookingAt() verlangt einen Treffer am Anfang des Suchbereichs, aber nicht über den gesamten Bereich. matches() verlangt, dass der gesamte Bereich passt. find() sucht an jeder Stelle im Bereich, die das Muster zulässt.
Beispiele
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Matcher matcher = Pattern.compile("[0-9]+").matcher("A12 B7");
while (matcher.find()) {
System.out.println(matcher.group() + " [" + matcher.start()
+ ", " + matcher.end() + ")");
}
if (matcher.find(4)) {
System.out.println("find(4): " + matcher.group());
}
}
}Ergebnis
12 [1, 3) 7 [5, 6) find(4): 7
`[0-9]+` findet Folgen aus mindestens einer ASCII-Ziffer. Die Schleife gibt `12` und `7` mit ihren Bereichen aus. Danach startet `find(4)` bei `B` und findet `7` am Index `5`.
Zugehörige Lektionen
- Java · Lektion 70 · Grundlagen · Version: 2