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

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

Източници