CKTIS / Java
Matcher.group() e Matcher.group(int): corrispondenza completa e gruppi
Dopo una corrispondenza con l’espressione regolare, recupera l’intero testo corrispondente o quello catturato da un gruppo specifico. Il gruppo 0 indica la corrispondenza completa.
Versione: Java SE 21
Sintassi
public String group()
public String group(int group)In Java SE 21, java.util.regex.Matcher offre tre overload di group che restituiscono un String. Qui si descrivono group() e group(int); il terzo overload, group(String), restituisce il testo catturato da un gruppo con nome. Matcher.group() restituisce l’intero frammento di input corrispondente ed equivale a group(0). Con un indice da 1 a groupCount(), Matcher.group(int) restituisce il testo catturato dal gruppo selezionato. I gruppi di cattura sono numerati da sinistra a destra in base alle parentesi di apertura. Un gruppo non catturante (?:...) non riceve un numero e groupCount() non include il gruppo 0.
Leggi i gruppi dopo che matches(), find() o lookingAt() ha restituito true. matches() verifica l’intera regione corrente dell’input, find() cerca il prossimo frammento corrispondente e lookingAt() verifica che una corrispondenza inizi all’inizio della regione senza doverla coprire interamente. I metodi group non eseguono la ricerca. Leggi i valori che ti servono prima del tentativo successivo o di una chiamata a reset().
Se la corrispondenza complessiva riesce ma il gruppo scelto non partecipa, group(int) restituisce null. Se il gruppo partecipa e corrisponde a zero caratteri, restituisce la stringa vuota "". Prima di qualsiasi tentativo, dopo un tentativo fallito o dopo reset() senza un nuovo tentativo, entrambi gli overload lanciano IllegalStateException. Con uno stato di corrispondenza valido, un indice fuori intervallo provoca IndexOutOfBoundsException. Cambiare il pattern con usePattern(...) dopo una corrispondenza elimina i dati dei gruppi; prima del tentativo successivo, entrambi gli overload possono restituire null.
Esempi
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern pattern = Pattern.compile("(ID)-([0-9]+)([A-Z])?([ ]*)");
Matcher matcher = pattern.matcher("item: ID-42");
if (matcher.find()) {
System.out.println("group() = [" + matcher.group() + "]");
System.out.println("group(0) = [" + matcher.group(0) + "]");
System.out.println("group(1) = [" + matcher.group(1) + "]");
System.out.println("group(2) = [" + matcher.group(2) + "]");
System.out.println("group(3) = " + matcher.group(3));
System.out.println("group(4) = [" + matcher.group(4) + "]");
}
}
}Risultato
group() = [ID-42] group(0) = [ID-42] group(1) = [ID] group(2) = [42] group(3) = null group(4) = []
`find()` trova `ID-42` in `item: ID-42`. Il gruppo 3 non partecipa perché manca la lettera facoltativa. Il gruppo 4 corrisponde a zero spazi, quindi `[]` mostra una stringa vuota.
Lezioni correlate
- Java · Lezione 70 · Base · Versione: 2