CKTIS / Java
Pattern.matcher — Ustvarjanje objekta Matcher za vhod
`Pattern.matcher` ustvari nov objekt `Matcher` za podani vhod. Isti prevedeni vzorec lahko uporabiš za več besedil, pri čemer ima vsako svoje stanje iskanja.
Različica: Java SE 21
Sintaksa
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) je metoda primerka razreda Pattern iz paketa java.util.regex. Najprej prevedi regularni izraz z Pattern.compile(regex), nato na dobljenem vzorcu pokliči pattern.matcher(input). Argument, na primer String, je besedilo za preverjanje, ne regularni izraz. Če podaš null, se sproži NullPointerException.
Vsak klic vrne nov Matcher, ne da bi že iskal ujemanje. find() poišče naslednji ujemajoči se podniz, lookingAt() poskusi najti ujemanje od začetka območja, matches() pa preveri celotno območje. Privzeto območje zajema celoten vhod. Vse tri metode vrnejo boolean.
Po uspešnem ujemanju group() vrne celoten ujemajoči se podniz. Klic pred prvim poskusom ali po neuspešnem poskusu sproži IllegalStateException. V zanki zato pokliči group() le, ko find() vrne true.
Objekt Pattern je nespremenljiv in si ga niti lahko delijo. Objekt Matcher hrani spremenljivo stanje iskanja in ni varen za sočasno uporabo. Kadar potrebuješ neodvisna stanja, ustvari ločene objekte Matcher. reset() obdrži vhod, reset(newInput) pa ga zamenja; obe metodi zavržeta prejšnji rezultat in znova nastavita območje na celoten vhod.
Primeri
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());
}
}Rezultat
12 34 true
`[0-9]+` se ujema z eno ali več zaporednimi števkami ASCII. Prvi `Matcher` izpiše `12` in `34`. Drugi uporabi isti vzorec in izpiše `true`, saj se njegov celotni vhod `56` ujema z vzorcem.
Povezane lekcije
- Java · Lekcija 70 · Osnovna · Različica: 2