CKTIS / Java
Pattern.matcher — Créer un Matcher pour un texte
`Pattern.matcher` crée un nouveau `Matcher` pour le texte fourni. Un même motif compilé peut servir à traiter plusieurs textes tout en conservant des états de recherche distincts.
Version : Java SE 21
Syntaxe
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) est une méthode d’instance de Pattern, dans le paquet java.util.regex. Compilez d’abord l’expression régulière avec Pattern.compile(regex), puis appelez pattern.matcher(input) sur le motif obtenu. L’argument, par exemple un String, est le texte à examiner, et non l’expression régulière. Passer null déclenche une NullPointerException.
Chaque appel renvoie un nouveau Matcher sans effectuer de recherche. find() cherche la prochaine sous-chaîne qui correspond au motif, lookingAt() tente une correspondance à partir du début de la région et matches() teste la région entière. Par défaut, la région couvre toute l’entrée. Les trois méthodes renvoient un boolean.
Après une correspondance réussie, group() renvoie toute la sous-chaîne trouvée. Un appel avant la première tentative ou après une tentative infructueuse déclenche une IllegalStateException. Dans une boucle, n’appelez donc group() que si find() renvoie true.
Un Pattern est immuable et peut être partagé entre plusieurs threads. Un Matcher conserve un état modifiable et ne peut pas être utilisé simultanément par plusieurs threads en toute sécurité. Créez des objets Matcher distincts pour obtenir des états indépendants. reset() conserve l’entrée, tandis que reset(newInput) la remplace. Les deux méthodes effacent le résultat précédent et rétablissent une région couvrant toute l’entrée.
Exemples
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern digits = Pattern.compile("[0-9]+");
Matcher scan = digits.matcher("A12 B34");
Matcher whole = digits.matcher("56");
while (scan.find()) {
System.out.println(scan.group());
}
System.out.println(whole.matches());
}
}Résultat
12 34 true
`[0-9]+` correspond à un ou plusieurs chiffres ASCII consécutifs. Le premier `Matcher` affiche `12` et `34`. Le second utilise le même motif et affiche `true`, car toute son entrée, `56`, correspond au motif.
Leçons associées
- Java · Leçon 70 · Débutant · Version : 2