Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

String.matches : vérifier qu’une chaîne entière correspond à une expression régulière

Vérifiez la correspondance sur toute la chaîne. Découvrez l’effet de `(?s)` sur le point, les classes de caractères limitées à ASCII par défaut et la notation des barres obliques inverses dans les littéraux Java.

Version : Java SE 21

Syntaxe

public boolean matches(String regex)

String.matches est une méthode d’instance de java.lang.String. L’appel text.matches(regex) interprète son argument comme une expression régulière et renvoie true seulement si tout text correspond, et non une simple sous-chaîne. Les ancres ^ et $ ne sont pas nécessaires. Pour rechercher une sous-chaîne correspondante, utilisez Pattern.compile(regex).matcher(text).find().

Placez (?s) au début du motif pour activer DOTALL : . reconnaît alors aussi les caractères de fin de ligne, qu’il exclut par défaut. Ne confondez pas (?s) et (?m) : MULTILINE modifie le comportement des ancres ^ et $, pas celui du point.

Dans une expression régulière, [A-Z] désigne les lettres majuscules ASCII de A à Z. Par défaut, \d équivaut à [0-9] et \w à [a-zA-Z_0-9]. L’option (?U) (UNICODE_CHARACTER_CLASS) active les variantes Unicode de ces classes prédéfinies, sans élargir l’intervalle explicite [A-Z].

Les littéraux de chaîne Java et les expressions régulières sont interprétés séparément. Écrivez "\\d" pour transmettre \d au moteur, et "\\." pour lui transmettre \. et reconnaître un point littéral. Un motif invalide lève PatternSyntaxException, tandis qu’un argument null lève NullPointerException ; aucun de ces cas ne renvoie false. Si vous réutilisez le même motif, compilez-le une fois avec Pattern.compile(regex), puis appelez pattern.matcher(text).matches() pour chaque chaîne.

Exemples

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"));
    }
}

Résultat

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` correspond en entier, tandis que `find()` repère une sous-chaîne correspondante dans `XAB.42`. Le trait d’union ne remplace pas le point littéral. Les chiffres arabo-indiens ne correspondent qu’avec `(?U)`, et le point ne reconnaît le saut de ligne qu’avec `(?s)`.

Leçons associées

  • Java · Leçon 1 · Intermédiaire · Version : 2

Sources