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

CKTIS / Java

Pattern — une expression régulière compilée

java.util.regex.Pattern stocke une expression régulière compilée. Pattern.compile crée le motif, et Pattern.matcher crée un Matcher pour vérifier une entrée entière ou rechercher des sous-séquences correspondantes.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean wholeInputMatches = matcher.matches();
boolean nextMatchFound = matcher.find();

java.util.regex.Pattern représente une expression régulière compilée. Pattern.compile(regex) crée un motif, et Pattern.matcher(input) crée un Matcher pour le texte fourni. C’est le Matcher qui effectue la correspondance ; créer le motif ne suffit pas.

La syntaxe des expressions régulières décrit le texte accepté. Dans ID-(\d{3}), ID- est littéral, \d désigne par défaut un chiffre ASCII, {3} exige trois répétitions et les parenthèses forment un groupe capturant. Dans les littéraux de chaîne Java, il faut doubler les barres obliques inverses : "ID-(\\d{3})".

matches() vérifie toute la région de correspondance, qui correspond par défaut à toute l’entrée. find() recherche la prochaine sous-séquence correspondante. Après une correspondance réussie, group(1) renvoie le texte du premier groupe ; ici, c’est 042, toujours sous forme de texte.

Compilez une seule fois un motif réutilisé. Pattern est immuable et peut être partagé entre threads en toute sécurité ; ce n’est pas le cas de Matcher. Une syntaxe invalide provoque PatternSyntaxException. Pour traiter un texte littéralement plutôt que comme une syntaxe regex, utilisez Pattern.quote(text).

Exemples

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

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("ID-(\\d{3})");
        System.out.println(pattern.matcher("ID-042").matches());
        System.out.println(pattern.matcher("Order ID-042").matches());

        Matcher matcher = pattern.matcher("Order ID-042");
        if (matcher.find()) {
            System.out.println(matcher.group(1));
        }
    }
}

Résultat

true
false
042

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources