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

CKTIS / Java

String.matches: porovnání celého řetězce s regulárním výrazem

Ověř, zda celý řetězec odpovídá regulárnímu výrazu. Zjisti, jak `(?s)` mění chování tečky, které třídy znaků ve výchozím nastavení používají ASCII a jak zapsat zpětná lomítka v literálech Javy.

Verze: Java SE 21

Syntaxe

public boolean matches(String regex)

String.matches je instanční metoda třídy java.lang.String. Volání text.matches(regex) chápe argument jako regulární výraz a vrátí true, jen pokud odpovídá celý text, ne pouze jeho část. Kotvy ^ a $ k tomu nepotřebuješ. K vyhledání odpovídajícího podřetězce použij Pattern.compile(regex).matcher(text).find().

Na začátek vzoru vlož (?s), čímž zapneš režim DOTALL: . pak odpovídá i znakům konce řádku, které jinak nezahrnuje. Nezaměňuj (?s) s (?m): režim MULTILINE mění chování kotev ^ a $, nikoli tečky.

V regulárním výrazu značí [A-Z] rozsah velkých písmen ASCII od A do Z. Ve výchozím nastavení je \d totéž co [0-9] a \w totéž co [a-zA-Z_0-9]. Příznak (?U) (UNICODE_CHARACTER_CLASS) zapne varianty těchto předdefinovaných tříd podle Unicode, ale explicitní rozsah [A-Z] nerozšíří.

Řetězcové literály v Javě a regulární výrazy se zpracovávají odděleně. Zápisem "\\d" předáš modulu pro regulární výrazy \d; zápisem "\\." mu předáš \. a vzor pak odpovídá doslovné tečce. Neplatný vzor vyvolá PatternSyntaxException a argument null vyvolá NullPointerException; ani v jednom případě metoda nevrátí false. Pokud stejný vzor používáš opakovaně, zkompiluj ho jednou pomocí Pattern.compile(regex) a pro každý řetězec volej pattern.matcher(text).matches().

Příklady

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

Výsledek

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` odpovídá celé, zatímco v `XAB.42` najde `find()` odpovídající podřetězec. Spojovník nenahrazuje doslovnou tečku. Arabsko-indické číslice odpovídají jen s `(?U)` a tečka odpovídá konci řádku jen s `(?s)`.

Související lekce

  • Java · Lekce 1 · Středně pokročilá · Verze: 2

Zdroje