CKTIS / Java
Pattern.matcher — Een Matcher maken voor invoer
`Pattern.matcher` maakt een nieuwe `Matcher` voor de opgegeven invoer. Je kunt één gecompileerd patroon hergebruiken voor meerdere teksten met elk een eigen zoekstatus.
Versie: Java SE 21
Syntax
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) is een instantiemethode van Pattern in het pakket java.util.regex. Compileer eerst de reguliere expressie met Pattern.compile(regex) en roep daarna pattern.matcher(input) aan op het verkregen patroon. Het argument, bijvoorbeeld een String, is de te controleren tekst, niet de reguliere expressie. Bij null krijg je een NullPointerException.
Elke aanroep geeft een nieuwe Matcher terug zonder al naar een overeenkomst te zoeken. find() zoekt het volgende passende tekstfragment, lookingAt() probeert het patroon vanaf het begin van het gebied te laten overeenkomen en matches() controleert het hele gebied. Standaard omvat dat gebied de volledige invoer. Alle drie de methoden geven een boolean terug.
Na een geslaagde poging geeft group() het volledige gevonden tekstfragment terug. Een aanroep vóór de eerste poging of na een mislukte poging levert een IllegalStateException op. Roep group() in een lus daarom alleen aan als find() true teruggeeft.
Een Pattern is onveranderlijk en kan door meerdere threads worden gedeeld. Een Matcher houdt veranderlijke zoekstatus bij en is niet veilig voor gelijktijdig gebruik. Maak afzonderlijke matchers als je onafhankelijke zoekstatus nodig hebt. reset() behoudt de invoer en reset(newInput) vervangt die; beide wissen het vorige resultaat en stellen het gebied weer in op de volledige invoer.
Voorbeelden
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());
}
}Resultaat
12 34 true
`[0-9]+` komt overeen met een of meer opeenvolgende ASCII-cijfers. De eerste `Matcher` drukt `12` en `34` af. De tweede gebruikt hetzelfde patroon en drukt `true` af omdat zijn volledige invoer, `56`, overeenkomt.
Gerelateerde lessen
- Java · Les 70 · Basis · Versie: 2