Matches, collection

---

Description

Collection d'objets Match sous forme d'expressions régulières.

Notes

Une collection Matches contient des objets individuels Match et peut être créée seulement à l'aide de la méthode Execute de l'objet RegExp. La collection Matches possède uniquement la propriété d'être en lecture seule, tout comme les objets individuels Match.

Lorsqu'une expression régulière est exécutée, il en résulte aucun, un ou plusieurs objets Match. Chaque objet Match procure un accès à la chaîne trouvée par l'expression régulière, fournit la longueur de la chaîne et un index indiquant où a été trouvée la correspondance.

Le code suivant montre la façon d'obtenir une collection Matches en utilisant une recherche d'expression régulière et la façon de parcourir la collection :

Function RegExpTest(patrn, strng)
  Dim regEx, Match, Matches		' Crée la variable.
  Set regEx = New RegExp			' Crée l'expression régulière.
  regEx.Pattern = patrn			' Définit les critères.
  regEx.IgnoreCase = True			' Définit le respect de la casse.
  regEx.Global = True			' Définit le champ d'application
  Set Matches = regEx.Execute(strng)	' Lance la recherche.
  For Each Match in Matches		' Itère la collection Matches.
    RetStr = RetStr & " Correspondance trouvée à la position "
    RetStr = RetStr & Match.FirstIndex & ". La valeur de la correspondance est "
    RetStr = RetStr & Match.Value & "'." & vbCRLF
  Next
  RegExpTest = RetStr
End Function

MsgBox(RegExpTest("est.", "IS1 is2 IS3 is4"))