CKTIS / Java
Pattern — skompilovaný regulárny výraz
java.util.regex.Pattern uchováva skompilovaný regulárny výraz. Pattern.compile vytvorí vzor a Pattern.matcher vytvorí Matcher na kontrolu celého vstupu alebo vyhľadávanie zodpovedajúcich podreťazcov.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();java.util.regex.Pattern predstavuje skompilovaný regulárny výraz. Pattern.compile(regex) vytvorí vzor a Pattern.matcher(input) vytvorí objekt Matcher pre zadaný text. Samotné porovnávanie vykonáva Matcher; vytvorenie vzoru samo osebe nestačí.
Syntax regulárnych výrazov opisuje prípustný text. V ID-(\d{3}) je ID- doslovný text, \d štandardne označuje číslicu ASCII, {3} vyžaduje tri opakovania a zátvorky tvoria zachytávaciu skupinu. V reťazcových literáloch Javy treba spätné lomky zdvojiť: "ID-(\\d{3})".
matches() kontroluje celú oblasť porovnávania, ktorá je predvolene celým vstupom. find() hľadá ďalší zodpovedajúci podreťazec. Po úspešnom porovnaní vráti group(1) text prvej skupiny; v tomto prípade 042, stále ako text.
Vzor, ktorý opakovane používate, skompilujte raz. Pattern je nemenný a možno ho bezpečne zdieľať medzi vláknami; Matcher nie. Neplatná syntax spôsobí PatternSyntaxException. Ak sa má text chápať doslovne, nie ako syntax regexu, použite Pattern.quote(text).
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("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ýsledok
true false 042
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.