Match, objet

Procure un accès aux propriétés d'une correspondance d'expression régulière.

Notes

Un objet Match peut être créé seulement par l'intermédiaire de la méthode Execute de l'objet RegExp. Ce dernier renvoie une collection d'objets Match. Toutes les propriétés des objets Match sont en lecture seule.

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 comment utiliser un objet Match :

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   ' Ignore 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 " & I & " 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"))

Propriétés

FirstIndex, propriété | Length, propriété | Value, propriété

Version requise

Version 5

Voir aussi

Matches, collection | RegExp, objet | SubMatches, collection