CKTIS / Java
`Matcher.matches()`: podudaranje cijelog područja u Javi
`Matcher.matches()` provjerava odgovara li regularni izraz cijelom trenutačnom području, a ne samo njegovu dijelu. Područje prema zadanim postavkama obuhvaća cijeli ulaz.
Verzija: Java SE 21
Sintaksa
public boolean matches()Matcher.matches() instancijska je metoda klase java.util.regex.Matcher bez argumenata. Prevedi regularni izraz pomoću Pattern.compile(regex), stvori objekt Matcher pozivom pattern.matcher(input) i pozovi matcher.matches(). Metoda vraća true samo ako uzorak odgovara cijelom trenutačnom području; inače vraća false.
Prema zadanim postavkama područje obuhvaća cijeli ulaz. Granice postavi metodom region(start, end): indeks start je uključen, a end isključen. Kad postaviš granice, matches() zahtijeva podudaranje cijelog odabranog područja, a ne cijelog izvornog ulaza. Nije potrebno dodavati sidra ^ i $ samo da bi se zahtijevalo podudaranje cijelog područja.
Upotrijebi lookingAt() ako je dovoljno podudaranje na početku područja ili find() ako želiš pronaći sljedeći podudarni dio u području. Kad matches() vrati true, group() vraća podudarni tekst, a start() i end() vraćaju njegove indekse u ulazu: početni je uključen, a završni isključen. Nakon rezultata false te tri metode bacaju IllegalStateException ako ih pozoveš prije sljedećeg uspješnog podudaranja.
Primjeri
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
Uzorak `[0-9]{4}` zahtijeva točno četiri znamenke ASCII. Cijeli niz `id=1234!` ne odgovara uzorku, ali `find()` pronalazi `1234`. U nizu `1234!` metoda `lookingAt()` pronalazi podudaranje na početku. Područje `[3, 7)` niza `id=1234!` sadrži samo `1234`, pa `matches()` vraća `true`, a `group()` vraća `1234`.
Povezane lekcije
- Java · Lekcija 70 · Osnovno · Verzija: 2