Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti