Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.matches: dopasowanie całego tekstu do wyrażenia regularnego

Sprawdź, czy cały napis pasuje do wyrażenia regularnego. Zobacz, jak `(?s)` zmienia działanie kropki, które klasy domyślnie używają ASCII i jak zapisać ukośnik odwrotny w literale Javy.

Wersja: Java SE 21

Składnia

public boolean matches(String regex)

String.matches to metoda instancyjna klasy java.lang.String. Wywołanie text.matches(regex) interpretuje argument jako wyrażenie regularne i zwraca true tylko wtedy, gdy pasuje cały text, a nie jedynie jego fragment. Nie trzeba dodawać kotwic ^ i $. Do wyszukiwania fragmentu służy Pattern.compile(regex).matcher(text).find().

Wstaw (?s) na początku wzorca, aby włączyć tryb DOTALL: wtedy . pasuje także do znaków końca wiersza. Bez tego trybu kropka ich nie dopasowuje. Nie myl (?s) z (?m): tryb MULTILINE zmienia działanie kotwic ^ i $, a nie kropki.

We wzorcu [A-Z] oznacza zakres wielkich liter ASCII od A do Z. Domyślnie \d oznacza [0-9], a \w oznacza [a-zA-Z_0-9]. Flaga (?U) (UNICODE_CHARACTER_CLASS) włącza warianty Unicode tych klas predefiniowanych, ale nie rozszerza jawnego zakresu [A-Z].

Literał Javy i wyrażenie regularne to dwie osobne warstwy. Zapisz "\\d", aby silnik otrzymał \d, oraz "\\.", aby otrzymał \. i dopasował zwykłą kropkę. Niepoprawny wzorzec powoduje PatternSyntaxException, a argument null powoduje NullPointerException; żaden z tych przypadków nie zwraca false. Gdy używasz tego samego wzorca wielokrotnie, skompiluj go raz przez Pattern.compile(regex) i dla każdego tekstu wywołuj pattern.matcher(text).matches().

Przykłady

import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        String code = "[A-Z]{2}\\.\\d{2}";
        String withPrefix = "XAB.42";
        String nonAsciiDigits = "AB.\u0664\u0662";
        String twoLines = "start\nend";

        System.out.println("whole: " + "AB.42".matches(code));
        System.out.println("prefixed whole: " + withPrefix.matches(code));
        System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
        System.out.println("wrong separator: " + "AB-42".matches(code));
        System.out.println("default digits: " + nonAsciiDigits.matches(code));
        System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
        System.out.println("default dot: " + twoLines.matches("start.*end"));
        System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
    }
}

Wynik

whole: true
prefixed whole: false
prefixed find: true
wrong separator: false
default digits: false
Unicode digits: true
default dot: false
DOTALL dot: true

`AB.42` pasuje w całości, natomiast w `XAB.42` metoda `find()` odnajduje tylko pasujący fragment. Łącznik nie zastępuje kropki. Cyfry arabsko-indyjskie pasują dopiero z `(?U)`, a kropka obejmuje znak końca wiersza dopiero z `(?s)`.

Powiązane lekcje

  • Java · Lekcja 1 · Średniozaawansowany · Wersja: 2

Źródła