CKTIS / Java
Pattern.matcher — Създаване на Matcher за входен текст
`Pattern.matcher` създава нов обект `Matcher` за подадения вход. Един и същ компилиран шаблон може да се използва с няколко текста, без те да споделят състоянието на търсенето.
Версия: Java SE 21
Синтаксис
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) е метод на екземпляр на класа Pattern от пакета java.util.regex. Първо компилирай регулярния израз с Pattern.compile(regex), след което извикай pattern.matcher(input) върху получения шаблон. Аргументът, например String, е текстът за проверка, а не регулярният израз. Подаването на null предизвиква NullPointerException.
Всяко извикване връща нов Matcher, без още да търси съвпадение. find() търси следващия съвпадащ подниз, lookingAt() опитва да намери съвпадение от началото на областта, а matches() проверява цялата област. По подразбиране областта обхваща целия вход. И трите метода връщат boolean.
След успешно съвпадение group() връща целия съвпадащ подниз. Извикването преди първия опит или след неуспешен опит предизвиква IllegalStateException. Затова в цикъл извиквай group() само когато find() върне true.
Обектът Pattern е неизменяем и може да се споделя между нишки. Обектът Matcher пази променливо състояние на търсенето и не е безопасен за едновременна употреба. Създавай отделни обекти Matcher, когато ти трябват независими състояния. reset() запазва входа, а reset(newInput) го заменя; и двата метода изчистват предишния резултат и връщат областта към целия вход.
Примери
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());
}
}Резултат
12 34 true
`[0-9]+` съвпада с една или повече последователни ASCII цифри. Първият `Matcher` отпечатва `12` и `34`. Вторият използва същия шаблон и отпечатва `true`, защото целият му вход `56` съвпада с шаблона.
Свързани уроци
- Java · Урок 70 · Начално · Версия: 2