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

CKTIS / Java

Pattern.compile — compiler une expression régulière

Compilez une expression régulière en un objet `Pattern`, puis réutilisez ce motif pour vérifier plusieurs chaînes en entrée.

Version : Java SE 21

Syntaxe

import java.util.regex.Pattern;

// Static method signatures in java.util.regex.Pattern:
public static Pattern compile(String regex)
public static Pattern compile(String regex, int flags)

Dans Java SE 21, Pattern.compile est une méthode statique de la classe java.util.regex.Pattern. Elle prend une expression régulière sous forme de String et renvoie un objet Pattern compilé. La compilation elle-même ne teste aucun texte en entrée.

Pattern.compile(regex) ne prend pas d’argument distinct pour les options, mais l’expression peut contenir une option intégrée telle que (?i). La surcharge Pattern.compile(regex, flags) prend un masque de bits de type int. Combinez les options avec |, par exemple Pattern.CASE_INSENSITIVE | Pattern.UNICODE_CASE pour ignorer la casse selon les règles Unicode.

Une syntaxe d’expression régulière invalide déclenche l’exception non vérifiée PatternSyntaxException à la compilation du motif. La surcharge avec options lève IllegalArgumentException si le masque contient des bits activés qui ne correspondent à aucune option définie.

pattern.matcher(input) crée un Matcher pour l’entrée fournie. Sa méthode matches() teste la totalité de la zone courante, qui couvre par défaut toute l’entrée. Pour chercher une sous-chaîne correspondante, utilisez plutôt find(). Pour des tests répétés, réutilisez le Pattern immuable, qui peut être partagé entre plusieurs threads. Un Matcher conserve l’état de la recherche et ne peut pas être utilisé simultanément par plusieurs threads sans précaution.

Exemples

import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern[] patterns = {
            Pattern.compile("[A-Z]{2}[0-9]{2}"),
            Pattern.compile("[0-9]+"),
            Pattern.compile("[A-Z]+"),
            Pattern.compile("[A-Z0-9]+"),
            Pattern.compile("AB.*")
        };

        System.out.println("Pattern | AB12 | 123");
        for (Pattern pattern : patterns) {
            System.out.println(pattern.pattern() + " | "
                    + pattern.matcher("AB12").matches() + " | "
                    + pattern.matcher("123").matches());
        }
    }
}

Résultat

Pattern | AB12 | 123
[A-Z]{2}[0-9]{2} | true | false
[0-9]+ | false | true
[A-Z]+ | false | false
[A-Z0-9]+ | true | true
AB.* | true | false

Le programme compile cinq motifs sans option et teste chacun sur `AB12` et `123`. Le motif `[A-Z]+` ne correspond pas à `AB12` : les lettres `AB` correspondent au motif, mais `matches()` exige que toute l’entrée corresponde.

Leçons associées

  • Java · Leçon 70 · Débutant · Version : 2

Sources