CKTIS / Java
`Matcher.matches()`: ujemanje celotnega območja v Javi
`Matcher.matches()` preveri, ali se regularni izraz ujema s celotnim trenutnim območjem, ne le z njegovim delom. Privzeto območje obsega celoten vhod.
Različica: Java SE 21
Sintaksa
public boolean matches()Matcher.matches() je metoda primerka razreda java.util.regex.Matcher brez argumentov. Prevedi regularni izraz z Pattern.compile(regex), ustvari Matcher s klicem pattern.matcher(input) in pokliči matcher.matches(). Metoda vrne true le, če se vzorec ujema s celotnim trenutnim območjem; sicer vrne false.
Privzeto območje obsega celoten vhod. Meji nastaviš z region(start, end): indeks start je vključen, indeks end pa izključen. Po nastavitvi mej mora pri matches() vzorcu ustrezati celotno izbrano območje, ne celoten prvotni vhod. Samo za zahtevo po ujemanju celotnega območja ni treba dodati sider ^ in $.
Če zadošča ujemanje na začetku območja, uporabi lookingAt(); za iskanje naslednjega ujemajočega se dela v območju uporabi find(). Ko matches() vrne true, group() vrne ujemajoče se besedilo, start() in end() pa vrneta njegova indeksa v vhodu: začetni je vključen, končni pa izključen. Po rezultatu false te tri metode sprožijo izjemo IllegalStateException, če jih pokličeš pred naslednjim uspešnim ujemanjem.
Primeri
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());
}
}
}Rezultat
false true true true 1234
Vzorec `[0-9]{4}` zahteva natanko štiri števke ASCII. Celoten niz `id=1234!` se ne ujema z vzorcem, vendar `find()` najde `1234`. Pri `1234!` metoda `lookingAt()` najde ujemanje na začetku. Območje `[3, 7)` niza `id=1234!` vsebuje samo `1234`, zato `matches()` vrne `true`, `group()` pa vrne `1234`.
Povezane lekcije
- Java · Lekcija 70 · Osnovna · Različica: 2