CKTIS / Java
`Matcher.matches()`: ověření shody v celé oblasti v Javě
`Matcher.matches()` ověřuje, zda regulární výraz odpovídá celé aktuální oblasti, nikoli jen její části. Ve výchozím nastavení oblast zahrnuje celý vstup.
Verze: Java SE 21
Syntaxe
public boolean matches()Matcher.matches() je bezparametrová instanční metoda třídy java.util.regex.Matcher. Zkompiluj regulární výraz pomocí Pattern.compile(regex), vytvoř objekt Matcher voláním pattern.matcher(input) a zavolej matcher.matches(). Metoda vrátí true pouze tehdy, když vzor odpovídá celé aktuální oblasti; jinak vrátí false.
Ve výchozím nastavení oblast zahrnuje celý vstup. Její hranice nastavíš pomocí region(start, end): index start do oblasti patří, index end nikoli. Po nastavení hranic musí při volání matches() vzor odpovídat celé vybrané oblasti, nikoli celému původnímu vstupu. Kotvy ^ a $ nemusíš přidávat jen kvůli požadavku na shodu v celé oblasti.
Použij lookingAt(), pokud stačí shoda na začátku oblasti, nebo find(), pokud hledáš další odpovídající úsek v oblasti. Když matches() vrátí true, group() poskytne text shody a start() a end() vrátí její indexy ve vstupu: počáteční včetně, koncový bez zahrnutí. Po výsledku false tyto tři metody vyvolají IllegalStateException, pokud je zavoláš před další úspěšnou shodou.
Příklady
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern fourDigits = Pattern.compile("[0-9]{4}");
String input = "id=1234!";
System.out.println(fourDigits.matcher(input).matches());
System.out.println(fourDigits.matcher(input).find());
System.out.println(fourDigits.matcher("1234!").lookingAt());
Matcher selected = fourDigits.matcher(input).region(3, 7);
boolean matched = selected.matches();
System.out.println(matched);
if (matched) {
System.out.println(selected.group());
}
}
}Výsledek
false true true true 1234
Vzor `[0-9]{4}` vyžaduje přesně čtyři číslice ASCII. Celý řetězec `id=1234!` neodpovídá, ale `find()` najde `1234`. U `1234!` najde `lookingAt()` shodu na začátku. Oblast `[3, 7)` řetězce `id=1234!` obsahuje jen `1234`, takže `matches()` vrátí `true` a `group()` vrátí `1234`.
Související lekce
- Java · Lekce 70 · Základní · Verze: 2