CKTIS / Java
Pattern.matcher — Vytvoření objektu Matcher pro vstup
`Pattern.matcher` vytvoří nový objekt `Matcher` pro zadaný vstup. Jeden zkompilovaný vzor lze použít pro více textů, aniž by sdílely stav vyhledávání.
Verze: Java SE 21
Syntaxe
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) je instanční metoda třídy Pattern z balíčku java.util.regex. Nejprve zkompiluj regulární výraz pomocí Pattern.compile(regex) a potom na získaném vzoru zavolej pattern.matcher(input). Argument, například String, je text ke kontrole, nikoli regulární výraz. Předání null vyvolá NullPointerException.
Každé volání vrátí nový Matcher, ale ještě nehledá shodu. find() hledá další odpovídající podřetězec, lookingAt() zkouší najít shodu od začátku oblasti a matches() ověřuje shodu celé oblasti. Ve výchozím nastavení oblast zahrnuje celý vstup. Všechny tři metody vracejí boolean.
Po úspěšném nalezení shody vrátí group() celý odpovídající podřetězec. Volání před prvním pokusem nebo po neúspěšném pokusu vyvolá IllegalStateException. Ve smyčce proto volej group() jen tehdy, když find() vrátí true.
Objekt Pattern je neměnný a lze ho sdílet mezi vlákny. Objekt Matcher uchovává měnitelný stav vyhledávání a není bezpečný pro souběžné použití. Pokud potřebuješ nezávislé stavy, vytvoř samostatné objekty Matcher. reset() ponechá vstup a reset(newInput) jej nahradí; obě metody zahodí předchozí výsledek a nastaví oblast zpět na celý vstup.
Příklady
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());
}
}Výsledek
12 34 true
`[0-9]+` odpovídá jedné nebo více po sobě jdoucím číslicím ASCII. První `Matcher` vypíše `12` a `34`. Druhý použije stejný vzor a vypíše `true`, protože vzoru odpovídá celý jeho vstup `56`.
Související lekce
- Java · Lekce 70 · Základní · Verze: 2