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

CKTIS / Java

Matcher — vérifier le texte et lire les correspondances

java.util.regex.Matcher applique une expression régulière à du texte. matches() vérifie toute la région, find() recherche successivement des sous-chaînes correspondantes et group() lit le résultat d’une correspondance réussie.

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

Syntaxe

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
    String match = matcher.group();
    // groupCount() counts capturing groups in the pattern, excluding group 0.
    // This guard checks that group 1 exists, not that it participated in the match.
    if (matcher.groupCount() >= 1) {
        String captured = matcher.group(1);
    }
}

java.util.regex.Matcher applique un motif Pattern à du texte. Créez-le avec pattern.matcher(input). L’objet conserve l’état de la recherche ; ne le partagez pas entre plusieurs threads.

Matcher.matches() vérifie toute la région courante, qui correspond par défaut à l’intégralité de l’entrée. Matcher.find() recherche la prochaine sous-chaîne correspondante ; les appels successifs font avancer la recherche. Les deux méthodes renvoient un boolean. reset() efface l’état de la recherche et rétablit une région couvrant toute l’entrée.

Matcher.group() et group(0) renvoient la correspondance entière. Les groupes capturants sont numérotés à partir de 1, dans l’ordre des parenthèses ouvrantes : group(1) lit le premier. groupCount() renvoie le nombre de groupes capturants définis dans le motif, sans compter le groupe 0. La condition matcher.groupCount() >= 1 vérifie donc que le groupe 1 existe, et non qu’il a participé à la correspondance. Lisez un groupe nommé avec group("name"). Pour un groupe facultatif qui n’a pas participé à la correspondance, group() avec l’indice ou le nom de ce groupe renvoie null ; si le groupe a capturé une chaîne vide, la méthode renvoie "".

Lisez les groupes après un résultat true : avant toute tentative de correspondance ou après un échec, group() lève une IllegalStateException. Dans l’exemple, matches() renvoie false, car le motif ne couvre pas toute l’entrée. Après reset(), la boucle find() lit deux correspondances et leurs groupes.

Exemples

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

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
        Matcher matcher = pattern.matcher("AB-12 CD-7");

        System.out.println("matches=" + matcher.matches());
        matcher.reset();
        while (matcher.find()) {
            System.out.println(matcher.group() + " | "
                    + matcher.group(1) + " | " + matcher.group(2));
        }
    }
}

Résultat

matches=false
AB-12 | AB | 12
CD-7 | CD | 7

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