CKTIS / Java
Matcher — verificare il testo e leggere le corrispondenze
java.util.regex.Matcher applica un’espressione regolare al testo. matches() controlla l’intera regione, find() cerca sottostringhe successive e group() legge il risultato di una corrispondenza riuscita.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
String match = matcher.group();
// groupCount() counts capturing groups in the pattern, excluding group 0.
// This guard checks that group 1 exists, not that it participated in the match.
if (matcher.groupCount() >= 1) {
String captured = matcher.group(1);
}
}java.util.regex.Matcher confronta un Pattern con il testo. Crealo con pattern.matcher(input). L’oggetto conserva lo stato della ricerca; non condividerlo tra più thread.
Matcher.matches() controlla l’intera regione corrente, che per impostazione predefinita coincide con tutto l’input. Matcher.find() cerca la sottostringa corrispondente successiva; le chiamate ripetute fanno avanzare la ricerca. Entrambi i metodi restituiscono boolean. reset() elimina lo stato della corrispondenza e ripristina una regione che comprende tutto l’input.
Matcher.group() e group(0) restituiscono l’intera corrispondenza. I gruppi di cattura sono numerati a partire da 1 nell’ordine delle parentesi aperte: group(1) legge il primo. Leggi un gruppo con nome usando group("name"). Un gruppo opzionale che non ha partecipato restituisce null, mentre un gruppo che corrisponde a testo vuoto restituisce "".
Leggi i gruppi dopo un risultato true: prima di un tentativo di corrispondenza o dopo un tentativo non riuscito, group() genera una IllegalStateException. Nell’esempio, matches() restituisce false perché il pattern non copre tutto l’input. Dopo reset(), il ciclo find() legge due corrispondenze e i relativi gruppi.
Esempi
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
Matcher matcher = pattern.matcher("AB-12 CD-7");
System.out.println("matches=" + matcher.matches());
matcher.reset();
while (matcher.find()) {
System.out.println(matcher.group() + " | "
+ matcher.group(1) + " | " + matcher.group(2));
}
}
}Risultato
matches=false AB-12 | AB | 12 CD-7 | CD | 7
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.