Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje