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