CKTIS / Java
Pattern — zkompilovaný regulární výraz
java.util.regex.Pattern uchovává zkompilovaný regulární výraz. Pattern.compile vytvoří vzor a Pattern.matcher vytvoří Matcher pro kontrolu celého vstupu nebo hledání odpovídajících podřetězců.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();java.util.regex.Pattern představuje zkompilovaný regulární výraz. Pattern.compile(regex) vytvoří vzor a Pattern.matcher(input) vytvoří objekt Matcher pro zadaný text. Samotné porovnávání provádí Matcher; pouhé vytvoření vzoru nestačí.
Syntaxe regulárních výrazů popisuje přípustný text. V ID-(\d{3}) je ID- doslovný text, \d standardně označuje číslici ASCII, {3} vyžaduje tři opakování a závorky tvoří zachytávací skupinu. V řetězcových literálech Javy je nutné zpětná lomítka zdvojit: "ID-(\\d{3})".
matches() kontroluje celou oblast porovnávání, která ve výchozím nastavení odpovídá celému vstupu. find() hledá další odpovídající podřetězec. Po úspěšném porovnání vrátí group(1) text první skupiny; zde je to 042, stále jako text.
Vzor, který používáte opakovaně, zkompilujte jednou. Pattern je neměnný a lze jej bezpečně sdílet mezi vlákny; Matcher nikoli. Neplatná syntaxe vyvolá PatternSyntaxException. Pokud má být text považován za doslovný, nikoli za syntaxi regexu, použijte Pattern.quote(text).
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("ID-(\\d{3})");
System.out.println(pattern.matcher("ID-042").matches());
System.out.println(pattern.matcher("Order ID-042").matches());
Matcher matcher = pattern.matcher("Order ID-042");
if (matcher.find()) {
System.out.println(matcher.group(1));
}
}
}Výsledek
true false 042
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.