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

CKTIS / Java

Matcher.find : rechercher les correspondances successives

Utilisez `find()` pour parcourir les correspondances d’une expression régulière, ou `find(int start)` pour relancer la recherche à partir d’un indice donné.

Version : Java SE 21

Syntaxe

public boolean find()
public boolean find(int start)

Matcher.find est une méthode d’instance de java.util.regex.Matcher. Créez un Matcher avec pattern.matcher(input). Sur un objet neuf ou réinitialisé, find() part du début de la zone de recherche, qui couvre par défaut toute l’entrée. Réutilisez le même objet dans while (matcher.find()) : après une correspondance non vide, la recherche suivante reprend juste après celle-ci. true indique qu’une correspondance a été trouvée, même si elle est vide ; false indique qu’aucune autre correspondance n’a été trouvée.

Après true, group() donne le texte complet de la correspondance, start() son début inclus et end() sa fin exclue. Les indices commencent à zéro et se rapportent à l’entrée entière. Lisez le résultat avant une nouvelle tentative : l’API prévoit une IllegalStateException pour ces méthodes avant toute tentative ou après une tentative infructueuse.

find(int start) réinitialise le Matcher, rétablit la zone de recherche à toute l’entrée et cherche à partir de start. La correspondance n’a pas besoin de commencer exactement à cet indice. La méthode lève IndexOutOfBoundsException si start est négatif ou supérieur à la longueur de l’entrée. Pour poursuivre la recherche, appelez find() sans argument : find(int start) la relance à chaque appel.

lookingAt() exige une correspondance au début de la zone, sans devoir la couvrir entièrement. matches() exige que toute la zone corresponde. find() cherche à tout endroit de la zone où le motif le permet.

Exemples

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

public class Main {
    public static void main(String[] args) {
        Matcher matcher = Pattern.compile("[0-9]+").matcher("A12 B7");

        while (matcher.find()) {
            System.out.println(matcher.group() + " [" + matcher.start()
                    + ", " + matcher.end() + ")");
        }

        if (matcher.find(4)) {
            System.out.println("find(4): " + matcher.group());
        }
    }
}

Résultat

12 [1, 3)
7 [5, 6)
find(4): 7

`[0-9]+` reconnaît les suites d’au moins un chiffre ASCII. La boucle affiche `12` et `7` avec leurs intervalles. Après la boucle, `find(4)` part de `B` et trouve `7` à l’indice `5`.

Leçons associées

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

Sources