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.