CKTIS / Java
Matcher — kontrola textu a čtení shod
java.util.regex.Matcher aplikuje regulární výraz na text. matches() kontroluje celou oblast, find() postupně hledá odpovídající podřetězce a group() čte výsledek úspěšné shody.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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ává Pattern s textem. Vytvořte jej pomocí pattern.matcher(input). Objekt uchovává stav vyhledávání; nesdílejte jej mezi více vlákny.
Matcher.matches() kontroluje celou aktuální oblast, která ve výchozím nastavení zahrnuje celý vstup. Matcher.find() hledá další odpovídající podřetězec; opakovaná volání posouvají vyhledávání dál. Obě metody vracejí boolean. reset() zahodí stav shody a obnoví oblast tak, aby zahrnovala celý vstup.
Matcher.group() a group(0) vracejí celou shodu. Zachytávací skupiny se číslují od 1 podle pořadí otevíracích závorek: group(1) čte první skupinu. Pojmenovanou skupinu přečtěte pomocí group("name"). Volitelná skupina, která se shody nezúčastnila, vrací null, zatímco skupina odpovídající prázdnému textu vrací "".
Skupiny čtěte až po výsledku true: před pokusem o shodu nebo po neúspěšném pokusu vyvolá group() výjimku IllegalStateException. V příkladu vrací matches() false, protože vzor nepokrývá celý vstup. Po reset() přečte cyklus find() dvě shody a jejich skupiny.
Pří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ýsledek
matches=false AB-12 | AB | 12 CD-7 | CD | 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.