База знанияИзпитен център
BGБългарски
Избери език13

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

Източници