Replace, méthode

Remplace le texte trouvé dans une recherche d'expression régulière.

object.Replace(string1, string2)

Arguments

object

Requis. Il s'agit toujours du nom d'un objet RegExp.

string1

Requis. String1 est la chaîne de caractères dans laquelle le remplacement a été effectué.

string2

Requis. String2 est la chaîne de caractères de remplacement.

Notes

Les critères réels du remplacement du texte en cours sont définis par la propriété Pattern de l'objet RegExp.

La méthode Replace renvoie une copie de la chaîne string1 avec le texte de l'élément RegExp.Pattern remplacé par la chaîne string2. Si aucune correspondance n'est trouvée, une copie de la chaîne string1 est renvoyée sans qu'elle soit modifiée.

Le code suivant montre comment utiliser la méthode Replace.

Function ReplaceTest(patrn, replStr)
  Dim regEx, str1               ' Crée des variables.
  str1 = "Le renard s'est jeté sur le chien."
  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.
  ReplaceTest = regEx.Replace(str1, replStr)   ' Effectue le remplacement
End Function
MsgBox(ReplaceTest("renard", "chat"))      ' Remplace 'renard' par 'chat'.

De plus, la méthode Replace est en mesure de remplacer des sous-expressions selon les critères définis. L'appel suivant de la fonction présentée dans l'exemple ci-dessus permute chaque paire de mots de la chaîne d'origine :

MsgBox(ReplaceText("(\S+)(\s+)(\S+)", "$3$2$1"))   ' Permute les paires de mots.

Version requise

Version 5

Voir aussi

Execute, méthode | Test, méthode

Application : RegExp, objet