Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Matcher — provjera teksta i čitanje podudaranja

java.util.regex.Matcher primjenjuje regularni izraz na tekst. matches() provjerava cijelo područje, find() uzastopno traži podnizove koji odgovaraju, a group() čita rezultat uspješnog podudaranja.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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 uspoređuje Pattern s tekstom. Stvorite ga pomoću pattern.matcher(input). Objekt zadržava stanje pretraživanja; nemojte ga dijeliti između više dretvi.

Matcher.matches() provjerava cijelo trenutačno područje, koje prema zadanim postavkama obuhvaća cijeli ulaz. Matcher.find() traži sljedeći podniz koji odgovara; uzastopni pozivi pomiču pretraživanje naprijed. Obje metode vraćaju boolean. reset() odbacuje stanje podudaranja i vraća područje tako da obuhvaća cijeli ulaz.

Matcher.group() i group(0) vraćaju cijelo podudaranje. Grupe za hvatanje numeriraju se od 1 prema redoslijedu otvorenih zagrada: group(1) čita prvu. Imenujenu grupu pročitajte pomoću group("name"). Neobavezna grupa koja nije sudjelovala vraća null, dok grupa koja odgovara praznom tekstu vraća "".

Grupe čitajte nakon rezultata true: prije pokušaja podudaranja ili nakon neuspješnog pokušaja group() izbacuje IllegalStateException. U primjeru matches() vraća false jer uzorak ne obuhvaća cijeli ulaz. Nakon reset() petlja find() čita dva podudaranja i njihove grupe.

Primjeri

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));
        }
    }
}

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori