CKTIS / Java
`Matcher.matches()`: съвпадение на цялата област в Java
`Matcher.matches()` проверява дали регулярният израз съвпада с цялата текуща област, а не само с част от нея. По подразбиране областта обхваща целия вход.
Версия: Java SE 21
Синтаксис
public boolean matches()Matcher.matches() е метод на екземпляр на java.util.regex.Matcher, който не приема аргументи. Компилирай регулярния израз с Pattern.compile(regex), създай обект Matcher чрез pattern.matcher(input) и извикай matcher.matches(). Методът връща true само ако шаблонът съвпада с цялата текуща област; в противен случай връща false.
По подразбиране областта обхваща целия вход. Задай границите ѝ с region(start, end): индексът start е включен, а end е изключен. След задаване на границите matches() изисква съвпадение с цялата избрана област, а не с целия първоначален вход. Не е нужно да добавяш котвите ^ и $ само за да изискаш съвпадение с цялата област.
Използвай lookingAt(), ако е достатъчно съвпадение в началото на областта, или find(), за да потърсиш следващия съвпадащ фрагмент в областта. Когато matches() върне true, group() връща съвпадналия текст, а start() и end() връщат индексите му във входа: началният е включен, а крайният е изключен. След резултат false тези три метода хвърлят IllegalStateException, ако ги извикаш преди следващото успешно съвпадение.
Примери
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());
}
}
}Резултат
false true true true 1234
Шаблонът `[0-9]{4}` изисква точно четири ASCII цифри. Целият низ `id=1234!` не съвпада, но `find()` намира `1234`. При `1234!` методът `lookingAt()` намира съвпадение в началото. Областта `[3, 7)` от `id=1234!` съдържа само `1234`, затова `matches()` връща `true`, а `group()` връща `1234`.
Свързани уроци
- Java · Урок 70 · Начално · Версия: 2