Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje