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