CKTIS / Java
String.matches: проверка дали целият низ съвпада с регулярен израз
Провери дали целият низ съвпада с регулярен израз. Виж как `(?s)` променя поведението на точката, кои класове по подразбиране използват ASCII и как се записва обратна наклонена черта в литерал на Java.
Версия: Java SE 21
Синтаксис
public boolean matches(String regex)String.matches е метод на екземпляр на java.lang.String. Извикването text.matches(regex) тълкува аргумента като регулярен израз и връща true само ако съвпада целият text, а не само част от него. Не са нужни котвите ^ и $. За да намериш съвпадащ подниз, използвай Pattern.compile(regex).matcher(text).find().
Постави (?s) в началото на шаблона, за да включиш режима DOTALL: тогава . съвпада и със знаците за край на ред, които по подразбиране не обхваща. Не бъркай (?s) с (?m): MULTILINE променя поведението на котвите ^ и $, а не на точката.
В регулярен израз [A-Z] означава диапазона от главни ASCII букви от A до Z. По подразбиране \d означава [0-9], а \w означава [a-zA-Z_0-9]. Флагът (?U) (UNICODE_CHARACTER_CLASS) включва Unicode вариантите на тези предварително дефинирани класове, но не разширява изрично зададения диапазон [A-Z].
Низовите литерали на Java и регулярните изрази се обработват отделно. Напиши "\\d", за да подадеш \d на механизма за регулярни изрази, и "\\.", за да подадеш \. и да съпоставиш буквална точка. Невалиден шаблон предизвиква PatternSyntaxException, а аргумент null предизвиква NullPointerException; в нито един от двата случая методът не връща false. Ако използваш един и същ шаблон многократно, компилирай го веднъж с Pattern.compile(regex) и извиквай pattern.matcher(text).matches() за всеки низ.
Примери
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
String code = "[A-Z]{2}\\.\\d{2}";
String withPrefix = "XAB.42";
String nonAsciiDigits = "AB.\u0664\u0662";
String twoLines = "start\nend";
System.out.println("whole: " + "AB.42".matches(code));
System.out.println("prefixed whole: " + withPrefix.matches(code));
System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
System.out.println("wrong separator: " + "AB-42".matches(code));
System.out.println("default digits: " + nonAsciiDigits.matches(code));
System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
System.out.println("default dot: " + twoLines.matches("start.*end"));
System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
}
}Резултат
whole: true prefixed whole: false prefixed find: true wrong separator: false default digits: false Unicode digits: true default dot: false DOTALL dot: true
`AB.42` съвпада изцяло, а в `XAB.42` методът `find()` намира съвпадащ подниз. Тирето не може да замени буквалната точка. Арабско-индийските цифри съвпадат само с `(?U)`, а точката обхваща знака за нов ред само с `(?s)`.
Свързани уроци
- Java · Урок 1 · Средно · Версия: 2