Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

`Matcher.matches()`: verificare l’intera regione in Java

`Matcher.matches()` verifica se un’espressione regolare corrisponde all’intera regione corrente, non solo a un suo frammento. Per impostazione predefinita, la regione comprende tutto l’input.

Versione: Java SE 21

Sintassi

public boolean matches()

Matcher.matches() è un metodo di istanza senza argomenti di java.util.regex.Matcher. Compila l’espressione regolare con Pattern.compile(regex), crea un Matcher con pattern.matcher(input) e chiama matcher.matches(). Il metodo restituisce true solo se il pattern corrisponde all’intera regione corrente; altrimenti restituisce false.

Per impostazione predefinita, la regione comprende tutto l’input. Usa region(start, end) per impostarne i limiti: start è incluso ed end è escluso. A quel punto matches() richiede che il pattern corrisponda all’intera regione selezionata, non a tutto l’input originale. Non è necessario aggiungere ^ e $ solo per richiedere una corrispondenza con l’intera regione.

Usa lookingAt() se basta una corrispondenza all’inizio della regione oppure find() per cercare il prossimo frammento corrispondente nella regione. Se matches() restituisce true, group() restituisce il testo corrispondente, mentre start() ed end() ne restituiscono gli indici nell’input, rispettivamente di inizio incluso e di fine esclusa. Dopo false, questi tre metodi sollevano IllegalStateException se vengono chiamati prima di una nuova corrispondenza riuscita.

Esempi

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern fourDigits = Pattern.compile("[0-9]{4}");
        String input = "id=1234!";

        System.out.println(fourDigits.matcher(input).matches());
        System.out.println(fourDigits.matcher(input).find());
        System.out.println(fourDigits.matcher("1234!").lookingAt());

        Matcher selected = fourDigits.matcher(input).region(3, 7);
        boolean matched = selected.matches();
        System.out.println(matched);
        if (matched) {
            System.out.println(selected.group());
        }
    }
}

Risultato

false
true
true
true
1234

Il pattern `[0-9]{4}` richiede esattamente quattro cifre ASCII. `id=1234!` non corrisponde per intero, ma `find()` trova `1234`. Su `1234!`, `lookingAt()` riconosce il prefisso. La regione `[3, 7)` di `id=1234!` contiene solo `1234`, quindi `matches()` restituisce `true` e `group()` restituisce `1234`.

Lezioni correlate

  • Java · Lezione 70 · Base · Versione: 2

Fonti