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

CKTIS / Java

Matcher.group() et Matcher.group(int) : correspondance complète et groupes

Après une correspondance réussie, récupérez tout le texte correspondant ou le texte d’un groupe de capture précis. Le groupe 0 représente la correspondance complète.

Version : Java SE 21

Syntaxe

public String group()
public String group(int group)

Dans Java SE 21, java.util.regex.Matcher propose trois surcharges de group qui renvoient un String. Cette entrée présente group() et group(int) ; la troisième surcharge, group(String), renvoie le texte capturé par un groupe nommé. Matcher.group() renvoie tout le fragment correspondant dans l’entrée et équivaut à group(0). Avec un indice de 1 à groupCount(), Matcher.group(int) renvoie le texte capturé par le groupe choisi. Les groupes de capture sont numérotés de gauche à droite selon leur parenthèse ouvrante. Un groupe non capturant (?:...) ne reçoit aucun numéro et le groupe 0 n’est pas compté par groupCount().

Lisez les groupes après que matches(), find() ou lookingAt() a renvoyé true. matches() vérifie toute la région courante de l’entrée, find() recherche le prochain fragment correspondant et lookingAt() vérifie qu’une correspondance commence au début de la région sans devoir la couvrir entièrement. Les méthodes group ne lancent aucune recherche. Lisez les valeurs utiles avant la tentative suivante ou un appel à reset().

Si la correspondance globale réussit mais que le groupe choisi n’y participe pas, group(int) renvoie null. Si le groupe participe et reconnaît zéro caractère, le résultat est la chaîne vide "". Avant toute tentative, après un échec ou après reset() sans nouvelle tentative, les deux surcharges lèvent IllegalStateException. Lorsque l’état de correspondance est valide, un indice hors limites provoque IndexOutOfBoundsException. Changer le motif avec usePattern(...) après une réussite efface les données des groupes ; avant la tentative suivante, les deux surcharges peuvent renvoyer null.

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)-([0-9]+)([A-Z])?([ ]*)");
        Matcher matcher = pattern.matcher("item: ID-42");

        if (matcher.find()) {
            System.out.println("group() = [" + matcher.group() + "]");
            System.out.println("group(0) = [" + matcher.group(0) + "]");
            System.out.println("group(1) = [" + matcher.group(1) + "]");
            System.out.println("group(2) = [" + matcher.group(2) + "]");
            System.out.println("group(3) = " + matcher.group(3));
            System.out.println("group(4) = [" + matcher.group(4) + "]");
        }
    }
}

Résultat

group() = [ID-42]
group(0) = [ID-42]
group(1) = [ID]
group(2) = [42]
group(3) = null
group(4) = []

`find()` repère `ID-42` dans `item: ID-42`. Le groupe 3 ne participe pas, faute de lettre facultative. Le groupe 4 reconnaît zéro espace : `[]` représente donc une chaîne vide.

Leçons associées

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

Sources