Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori