База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Pattern — компилиран регулярен израз

java.util.regex.Pattern съхранява компилиран регулярен израз. Pattern.compile създава шаблона, а Pattern.matcher създава Matcher за проверка на цял вход или търсене на съвпадащи поднизове.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();

java.util.regex.Pattern представя компилиран регулярен израз. Pattern.compile(regex) създава шаблон, а Pattern.matcher(input) създава обект Matcher за подадения текст. Съвпаденията се проверяват от Matcher; самото създаване на шаблона не го прави.

Синтаксисът на регулярните изрази описва допустимия текст. В ID-(\d{3}) ID- е буквален текст, \d по подразбиране означава ASCII цифра, {3} изисква три повторения, а скобите образуват улавяща група. В низовите литерали на Java обратните наклонени черти трябва да се удвоят: "ID-(\\d{3})".

matches() проверява цялата област за съвпадение, която по подразбиране е целият вход. find() търси следващия съвпадащ подниз. След успешно съвпадение group(1) връща текста на първата група; тук това е 042, все още като текст.

Компилирайте шаблона, който ще използвате повторно, само веднъж. Pattern е неизменяем и може безопасно да се споделя между нишки; Matcher не може. Невалиден синтаксис предизвиква PatternSyntaxException. Когато текстът трябва да се третира буквално, а не като синтаксис на regex, използвайте Pattern.quote(text).

Примери

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));
        }
    }
}

Резултат

true
false
042

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници