CKTIS / Java
Matcher — preverjanje besedila in branje ujemanj
java.util.regex.Matcher uporabi regularni izraz na besedilu. matches() preveri celotno območje, find() zaporedoma išče ustrezne podnize, group() pa prebere rezultat uspešnega ujemanja.
Različica: 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 primerja Pattern z besedilom. Ustvarite ga z pattern.matcher(input). Objekt ohranja stanje iskanja; ne delite ga med več nitmi.
Matcher.matches() preveri celotno trenutno območje, ki privzeto obsega celoten vhod. Matcher.find() išče naslednji ustrezni podniz; ponovljeni klici pomikajo iskanje naprej. Obe metodi vrneta boolean. reset() zavrže stanje ujemanja in ponastavi območje tako, da obsega celoten vhod.
Matcher.group() in group(0) vrneta celotno ujemanje. Zajemne skupine so oštevilčene od 1 po vrstnem redu začetnih oklepajev: group(1) prebere prvo. Poimenovano skupino preberite z group("name"). Izbirna skupina, ki ni sodelovala pri ujemanju, vrne null, skupina, ki ustreza praznemu besedilu, pa vrne "".
Skupine berite šele po rezultatu true: pred poskusom ujemanja ali po neuspešnem poskusu group() sproži IllegalStateException. V primeru matches() vrne false, ker vzorec ne pokriva celotnega vhoda. Po reset() zanka find() prebere dve ujemanji in njuni skupini.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.