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

CKTIS / Java

Matcher — проверка на текст и извличане на съвпадения

java.util.regex.Matcher прилага регулярен израз към текст. matches() проверява целия регион, find() последователно търси съвпадащи поднизове, а group() прочита резултата от успешно съвпадение.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
    String match = matcher.group();
    // groupCount() counts capturing groups in the pattern, excluding group 0.
    // This guard checks that group 1 exists, not that it participated in the match.
    if (matcher.groupCount() >= 1) {
        String captured = matcher.group(1);
    }
}

java.util.regex.Matcher съпоставя Pattern с текст. Създайте го чрез pattern.matcher(input). Обектът запазва състоянието на търсенето; не го споделяйте между нишки.

Matcher.matches() проверява целия текущ регион, който по подразбиране обхваща целия вход. Matcher.find() търси следващия съвпадащ подниз; последователните извиквания придвижват търсенето напред. И двата метода връщат boolean. reset() изчиства състоянието на съвпадението и възстановява регион, който обхваща целия вход.

Matcher.group() и group(0) връщат цялото съвпадение. Улавящите групи се номерират от 1 според реда на отварящите скоби: group(1) прочита първата. Прочетете именувана група чрез group("name"). Незадължителна група, която не е участвала, връща null, а група, съвпадаща с празен текст, връща "".

Четете групите след резултат true: преди опит за съвпадение или след неуспешен опит group() хвърля IllegalStateException. В примера matches() връща false, защото шаблонът не обхваща целия вход. След reset() цикълът find() прочита две съвпадения и техните групи.

Примери

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
        Matcher matcher = pattern.matcher("AB-12 CD-7");

        System.out.println("matches=" + matcher.matches());
        matcher.reset();
        while (matcher.find()) {
            System.out.println(matcher.group() + " | "
                    + matcher.group(1) + " | " + matcher.group(2));
        }
    }
}

Резултат

matches=false
AB-12 | AB | 12
CD-7 | CD | 7

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници