Replace, méthode

---

Description

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

Syntaxe

object.Replace(string1, string2)

La syntaxe de la méthode Replace comprend les éléments suivants :

Élément	Description
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.

---