La classe Matcher dispose de méthodes de mise en correspondance d'un modèle par rapport à un texte cible et d'obtention des positions des occurrences trouvées.
La création d'un objet Matcher doit s'effectuer par l'entremise de la méthode matcher() d'un objet Pattern. La méthode prend un argument qui est une chaîne de caractères sur laquelle s'appliquera des mises en correspondance du modèle courant.
Matcher recherche = modele.matcher("Un texte quelconque...");Les méthodes de la classe Matcher se décomposent en trois groupes :
- Les méthodes de mise en correspondance (matches(), lookingAt(), find(), ...),
- Les méthodes d'informations (start(), end(), group(), ...),
- Les méthodes de remplacement (appendReplacement(), appendTail(), replaceAll() et replaceFirst()).
| Méthode |
|---|
| Description |
| Matcher appendReplacement(StringBuffer sb, String replacement) |
| remplace au sein de l'objet StringBuffer l'occurrence correspondant au modèle courant, par la chaîne de caractères de substitution. |
| StringBuffer appendTail(StringBuffer sb) |
| s'utilise après avoir invoqué la méthode appendReplacement(), elle ajoute les caractères restants après une opération de remplacement au sein d el'objet StringBuffer spécifié. |
| int end() |
| retourne la position du dernier caractère (+ 1) d'une occurrence correspondant au modèle courant. |
| int end(int group) |
| retourne la position du dernier caractère (+ 1) d'une occurrence capturée dans le groupe indiqué par son numéro. |
| boolean find() |
| exécute une recherche d'une occurrence qui correspond au modèle courant. |
| boolean find(int start) |
| réinitialise l'objet Matcher et exécute une recherche d'une occurrence qui correspond au modèle courant, à partir d'une position spécifiée. |
| String group() |
| retourne une occurrence correspondant au modèle courant suite à une opération de recherche. |
| String group(int group) |
| retourne une occurrence du groupe spécifié par son numéro, correspondant au modèle courant suite à une opération de recherche. |
| int groupCount() |
| retourne le nombre de groupe de capture suite à une opération de recherche du modèle. |
| boolean lookingAt() |
| exécute une recherche d'occurences correspondant au modèle courant en commençant toujours au début d'une zone de la chaîne de caractères cible. |
| boolean matches() |
| exécute une recherche d'occurences correspondant au modèle courant sur la totalité de la chaîne de caractères cible. |
| Pattern pattern() |
| retourne le modèle qui est appliqué par l'objet Matcher courant. |
| String replaceAll(String replacement) |
| remplace chaque occurrences correspondant au modèle courant, par la chaîne de caractères de substitution. |
| String replaceFirst(String replacement) |
| remplace la première occurrence correspondant au modèle courant, par la chaîne de caractères de substitution. |
| Matcher reset() |
| réinitialise l'objet courant. |
| Matcher reset(CharSequence input) |
| réinitialise 'objet Matcher avec une nouvelle chaîne de caractères. |
| int start() |
| retourne la position du premier caractère d'une occurrence correspondant au modèle courant. |
| int start(int group) |
| retourne la position du premier caractère d'une occurrence capturée dans le groupe indiqué par son numéro, correspondant au modèle courant. |
