WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Pattern.matcher — Einen Matcher für eine Eingabe erstellen

`Pattern.matcher` erzeugt einen neuen `Matcher` für die angegebene Eingabe. Ein kompiliertes Muster lässt sich für mehrere Texte wiederverwenden, ohne ihren Suchzustand zu teilen.

Version: Java SE 21

Syntax

public Matcher matcher(CharSequence input)

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);

Pattern.matcher(CharSequence input) ist eine Instanzmethode von Pattern aus java.util.regex. Kompiliere zuerst den regulären Ausdruck mit Pattern.compile(regex) und rufe dann pattern.matcher(input) auf dem erzeugten Muster auf. Das Argument, etwa ein String, ist der zu prüfende Text, nicht der reguläre Ausdruck. Bei null wird eine NullPointerException ausgelöst.

Jeder Aufruf liefert einen neuen Matcher, ohne bereits nach einem Treffer zu suchen. find() sucht den nächsten passenden Teilstring, lookingAt() versucht eine Übereinstimmung ab dem Beginn des Bereichs und matches() prüft den gesamten Bereich. Standardmäßig umfasst der Bereich die gesamte Eingabe. Alle drei Methoden geben einen boolean zurück.

Nach einem erfolgreichen Abgleich liefert group() den gesamten passenden Teilstring. Vor dem ersten Abgleichversuch oder nach einem fehlgeschlagenen Versuch löst der Aufruf eine IllegalStateException aus. Rufe group() in einer Schleife daher nur auf, wenn find() den Wert true zurückgibt.

Ein Pattern ist unveränderlich und kann von mehreren Threads gemeinsam verwendet werden. Ein Matcher speichert veränderlichen Suchzustand und ist nicht für die nebenläufige Nutzung geeignet. Verwende getrennte Matcher, wenn du unabhängigen Zustand brauchst. reset() behält die Eingabe bei, reset(newInput) ersetzt sie. Beide verwerfen das vorherige Ergebnis und setzen den Bereich auf die gesamte Eingabe zurück.

Beispiele

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern digits = Pattern.compile("[0-9]+");
        Matcher scan = digits.matcher("A12 B34");
        Matcher whole = digits.matcher("56");

        while (scan.find()) {
            System.out.println(scan.group());
        }
        System.out.println(whole.matches());
    }
}

Ergebnis

12
34
true

`[0-9]+` passt auf eine oder mehrere aufeinanderfolgende ASCII-Ziffern. Der erste `Matcher` gibt `12` und `34` aus. Der zweite verwendet dasselbe Muster und gibt `true` aus, weil seine gesamte Eingabe `56` passt.

Zugehörige Lektionen

  • Java · Lektion 70 · Grundlagen · Version: 2

Quellen