Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Matcher — kontrola textu a čítanie zhôd

java.util.regex.Matcher aplikuje regulárny výraz na text. matches() kontroluje celú oblasť, find() postupne hľadá zodpovedajúce podreťazce a group() číta výsledok úspešnej zhody.

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

Syntax

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 porovnáva Pattern s textom. Vytvorte ho pomocou pattern.matcher(input). Objekt uchováva stav vyhľadávania; nezdieľajte ho medzi viacerými vláknami.

Matcher.matches() kontroluje celú aktuálnu oblasť, ktorá predvolene zahŕňa celý vstup. Matcher.find() hľadá ďalší zodpovedajúci podreťazec; opakované volania posúvajú vyhľadávanie ďalej. Obe metódy vracajú boolean. reset() zahodí stav zhody a obnoví oblasť tak, aby zahŕňala celý vstup.

Matcher.group() a group(0) vracajú celú zhodu. Zachytávacie skupiny sa číslujú od 1 podľa poradia otváracích zátvoriek: group(1) číta prvú skupinu. Pomenovanú skupinu prečítate pomocou group("name"). Voliteľná skupina, ktorá sa na zhode nezúčastnila, vracia null, zatiaľ čo skupina zodpovedajúca prázdnemu textu vracia "".

Skupiny čítajte až po výsledku true: pred pokusom o zhodu alebo po neúspešnom pokuse vyvolá group() výnimku IllegalStateException. V príklade vracia matches() false, pretože vzor nepokrýva celý vstup. Po reset() prečíta cyklus find() dve zhody a ich skupiny.

Príklady

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

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje