CKTIS / Java
`Matcher.matches()`: overenie zhody v celej oblasti v Jave
`Matcher.matches()` overuje, či regulárny výraz zodpovedá celej aktuálnej oblasti, nie iba jej časti. V predvolenom nastavení oblasť zahŕňa celý vstup.
Verzia: Java SE 21
Syntax
public boolean matches()Matcher.matches() je bezparametrová inštančná metóda triedy java.util.regex.Matcher. Skompiluj regulárny výraz pomocou Pattern.compile(regex), vytvor objekt Matcher volaním pattern.matcher(input) a zavolaj matcher.matches(). Metóda vráti true iba vtedy, ak vzor zodpovedá celej aktuálnej oblasti; inak vráti false.
V predvolenom nastavení oblasť zahŕňa celý vstup. Hranice nastav pomocou region(start, end): index start do oblasti patrí, index end nie. Po nastavení hraníc musí pri volaní matches() vzor zodpovedať celej vybratej oblasti, nie celému pôvodnému vstupu. Kotvy ^ a $ netreba pridávať iba preto, aby bola zhoda povinná v celej oblasti.
Ak stačí zhoda na začiatku oblasti, použi lookingAt(). Ak hľadáš ďalší zodpovedajúci úsek v oblasti, použi find(). Keď matches() vráti true, group() vráti text zhody a start() a end() vrátia jej indexy vo vstupe: počiatočný vrátane a koncový bez zahrnutia. Po výsledku false tieto tri metódy vyvolajú IllegalStateException, ak ich zavoláš pred ďalšou úspešnou zhodou.
Prí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ýsledok
false true true true 1234
Vzor `[0-9]{4}` vyžaduje presne štyri číslice ASCII. Celý reťazec `id=1234!` nezodpovedá vzoru, ale `find()` nájde `1234`. Pri `1234!` nájde `lookingAt()` zhodu na začiatku. Oblasť `[3, 7)` reťazca `id=1234!` obsahuje len `1234`, takže `matches()` vráti `true` a `group()` vráti `1234`.
Súvisiace lekcie
- Java · Lekcia 70 · Základná · Verzia: 2