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