CKTIS / Java
`Matcher.matches()` : tester toute la région en Java
`Matcher.matches()` vérifie qu'une expression régulière correspond à toute la région courante, et pas seulement à un extrait. Par défaut, la région couvre toute l'entrée.
Version : Java SE 21
Syntaxe
public boolean matches()Matcher.matches() est une méthode d’instance sans argument de java.util.regex.Matcher. Compilez l’expression régulière avec Pattern.compile(regex), créez un Matcher avec pattern.matcher(input), puis appelez matcher.matches(). La méthode renvoie true uniquement si le motif correspond à toute la région courante ; sinon, elle renvoie false.
Par défaut, la région couvre toute l’entrée. Utilisez region(start, end) pour fixer ses bornes : start est inclus et end est exclu. Une fois ces bornes fixées, matches() exige que le motif corresponde à toute la région sélectionnée, et non à l’intégralité de l’entrée d’origine. Il n’est pas nécessaire d’ajouter ^ et $ pour exiger une correspondance sur toute la région.
Utilisez lookingAt() si une correspondance au début de la région suffit, ou find() pour chercher la prochaine sous-séquence correspondante dans la région. Lorsque matches() renvoie true, group() donne le texte correspondant, et start() et end() donnent ses indices de début inclus et de fin exclue dans l’entrée. Après false, ces trois méthodes lèvent IllegalStateException si elles sont appelées avant une nouvelle correspondance réussie.
Exemples
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());
}
}
}Résultat
false true true true 1234
Le motif `[0-9]{4}` exige exactement quatre chiffres ASCII. La chaîne `id=1234!` ne correspond pas dans son ensemble, mais `find()` trouve `1234`. Sur `1234!`, `lookingAt()` reconnaît le préfixe. La région `[3, 7)` de `id=1234!` ne contient que `1234` : `matches()` renvoie donc `true` et `group()` renvoie `1234`.
Leçons associées
- Java · Leçon 70 · Débutant · Version : 2