Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.matches: verificare se un’intera stringa corrisponde a un’espressione regolare

Verifica la corrispondenza dell’intera stringa. Scopri come `(?s)` cambia il comportamento del punto, quali classi usano ASCII per impostazione predefinita e come scrivere le barre inverse nei letterali Java.

Versione: Java SE 21

Sintassi

public boolean matches(String regex)

String.matches è un metodo di istanza di java.lang.String. La chiamata text.matches(regex) interpreta l’argomento come un’espressione regolare e restituisce true solo se corrisponde l’intero text, non una semplice sottostringa. Non servono le ancore ^ e $. Per cercare una sottostringa corrispondente, usa Pattern.compile(regex).matcher(text).find().

Metti (?s) all’inizio del pattern per attivare DOTALL: così . corrisponde anche ai caratteri di fine riga, che normalmente esclude. Non confondere (?s) con (?m): MULTILINE cambia il comportamento delle ancore ^ e $, non quello del punto.

In un’espressione regolare, [A-Z] indica l’intervallo delle lettere maiuscole ASCII da A a Z. Per impostazione predefinita, \d equivale a [0-9] e \w a [a-zA-Z_0-9]. Il flag (?U) (UNICODE_CHARACTER_CLASS) attiva le varianti Unicode di queste classi predefinite, ma non estende l’intervallo esplicito [A-Z].

I letterali stringa Java e le espressioni regolari vengono interpretati separatamente. Scrivi "\\d" per passare \d al motore e "\\." per passare \. e riconoscere un punto letterale. Un pattern non valido genera PatternSyntaxException e un argomento null genera NullPointerException; in nessuno dei due casi il metodo restituisce false. Se riusi lo stesso pattern, compilalo una volta con Pattern.compile(regex) e chiama pattern.matcher(text).matches() per ogni stringa.

Esempi

import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        String code = "[A-Z]{2}\\.\\d{2}";
        String withPrefix = "XAB.42";
        String nonAsciiDigits = "AB.\u0664\u0662";
        String twoLines = "start\nend";

        System.out.println("whole: " + "AB.42".matches(code));
        System.out.println("prefixed whole: " + withPrefix.matches(code));
        System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
        System.out.println("wrong separator: " + "AB-42".matches(code));
        System.out.println("default digits: " + nonAsciiDigits.matches(code));
        System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
        System.out.println("default dot: " + twoLines.matches("start.*end"));
        System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
    }
}

Risultato

whole: true
prefixed whole: false
prefixed find: true
wrong separator: false
default digits: false
Unicode digits: true
default dot: false
DOTALL dot: true

`AB.42` corrisponde per intero, mentre `find()` trova una sottostringa corrispondente in `XAB.42`. Il trattino non sostituisce il punto letterale. Le cifre arabo-indiane corrispondono solo con `(?U)` e il punto riconosce l’interruzione di riga solo con `(?s)`.

Lezioni correlate

  • Java · Lezione 1 · Intermedio · Versione: 2

Fonti