CKTIS / Java
Pattern.matcher — Creare un Matcher per un input
`Pattern.matcher` crea un nuovo `Matcher` per l’input indicato. Puoi riutilizzare lo stesso pattern compilato su più testi, mantenendo separato lo stato di ogni ricerca.
Versione: Java SE 21
Sintassi
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) è un metodo di istanza di Pattern nel pacchetto java.util.regex. Prima compila l’espressione regolare con Pattern.compile(regex), poi chiama pattern.matcher(input) sul pattern ottenuto. L’argomento, per esempio uno String, è il testo da esaminare, non l’espressione regolare. Passare null genera una NullPointerException.
Ogni chiamata restituisce un nuovo Matcher senza tentare ancora alcuna corrispondenza. find() cerca la prossima sottostringa che corrisponde al pattern, lookingAt() tenta una corrispondenza dall’inizio della regione e matches() verifica l’intera regione. Per impostazione predefinita, la regione comprende tutto l’input. Tutti e tre i metodi restituiscono un boolean.
Dopo una corrispondenza riuscita, group() restituisce tutta la sottostringa corrispondente. Chiamarlo prima del primo tentativo o dopo un tentativo fallito genera una IllegalStateException. In un ciclo, chiama group() solo se find() restituisce true.
Un Pattern è immutabile e può essere condiviso tra thread. Un Matcher conserva uno stato modificabile e non è sicuro per l’uso concorrente. Crea oggetti Matcher distinti quando ti servono stati indipendenti. reset() mantiene l’input e reset(newInput) lo sostituisce; entrambi scartano il risultato precedente e ripristinano la regione all’intero input.
Esempi
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());
}
}Risultato
12 34 true
`[0-9]+` corrisponde a una o più cifre ASCII consecutive. Il primo `Matcher` stampa `12` e `34`. Il secondo usa lo stesso pattern e stampa `true` perché tutto il suo input, `56`, corrisponde.
Lezioni correlate
- Java · Lezione 70 · Base · Versione: 2