Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje