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

CKTIS / Java

Pattern.matcher — Vytvorenie objektu Matcher pre vstup

`Pattern.matcher` vytvorí nový objekt `Matcher` pre zadaný vstup. Jeden skompilovaný vzor môžeš použiť pre viacero textov, pričom každý má vlastný stav vyhľadávania.

Verzia: Java SE 21

Syntax

public Matcher matcher(CharSequence input)

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);

Pattern.matcher(CharSequence input) je inštančná metóda triedy Pattern z balíka java.util.regex. Najprv skompiluj regulárny výraz pomocou Pattern.compile(regex) a potom na získanom vzore zavolaj pattern.matcher(input). Argument, napríklad String, je text na kontrolu, nie regulárny výraz. Odovzdanie null vyvolá NullPointerException.

Každé volanie vráti nový Matcher, ale ešte nehľadá zhodu. find() hľadá ďalší zhodný podreťazec, lookingAt() skúša nájsť zhodu od začiatku oblasti a matches() overuje zhodu celej oblasti. Predvolene oblasť zahŕňa celý vstup. Všetky tri metódy vracajú boolean.

Po úspešnom nájdení zhody vráti group() celý zhodný podreťazec. Volanie pred prvým pokusom alebo po neúspešnom pokuse vyvolá IllegalStateException. V cykle preto volaj group() len vtedy, keď find() vráti true.

Objekt Pattern je nemenný a môžeš ho zdieľať medzi vláknami. Objekt Matcher uchováva meniteľný stav vyhľadávania a nie je bezpečný pri súbežnom použití. Ak potrebuješ nezávislé stavy, vytvor samostatné objekty Matcher. reset() ponechá vstup a reset(newInput) ho nahradí; obe metódy zahodia predchádzajúci výsledok a nastavia oblasť späť na celý vstup.

Príklady

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern digits = Pattern.compile("[0-9]+");
        Matcher scan = digits.matcher("A12 B34");
        Matcher whole = digits.matcher("56");

        while (scan.find()) {
            System.out.println(scan.group());
        }
        System.out.println(whole.matches());
    }
}

Výsledok

12
34
true

`[0-9]+` zodpovedá jednej alebo viacerým po sebe idúcim čísliciam ASCII. Prvý `Matcher` vypíše `12` a `34`. Druhý použije rovnaký vzor a vypíše `true`, pretože celý jeho vstup `56` zodpovedá vzoru.

Súvisiace lekcie

  • Java · Lekcia 70 · Základná · Verzia: 2

Zdroje