Replace, fonction

---

Description

Renvoie une chaîne dans laquelle une sous-chaîne donnée a été remplacée par une autre sous-chaîne le nombre de fois spécifié.

Syntaxe

Replace(expression, find, replacewith[, start[, count[, compare]]])

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

Élément	Description
expression	Expression de chaîne contenant une sous-chaîne à remplacer.
find	Sous-chaîne recherchée.
replacewith	Sous-chaîne de remplacement.
start	Facultatif. Position dans l'argument expression où la recherche de sous-chaîne doit commencer. Si elle est omise, la position 1 est prise par défaut. Elle doit être utilisée en conjonction avec count.
count	Facultatif. Nombre de remplacements de sous-chaîne à effectuer. Si cette valeur est omise, la valeur par défaut -1, qui signifie tous les remplacements possibles, est employée. Elle doit être utilisée en conjonction avec start.
compare	Facultatif. Valeur numérique indiquant le type de comparaison à utiliser lors de l'évaluation des sous-chaînes. Reportez-vous à la section Valeurs. Si elle est omise, la valeur par défaut est 0, comparaison binaire.

Valeurs

L'argument compare peut prendre les valeurs suivantes :

Constante	Valeur	Description
vbBinaryCompare	0	Effectue une comparaison binaire.
vbTextCompare	1	Effectue une comparaison texte.

Valeurs renvoyées

La valeur Replace renvoie les valeurs suivantes :

Si	La fonction Replace renvoie
expression a une longueur nulle	Une chaîne de longueur nulle ("").
expression a la valeur Null	Une erreur.
find a une longueur nulle	Une copie d'expression.
replacewith a une longueur nulle	Une copie d'expression, toutes les occurrences de find étant retirées.
start > Len(expression)	Une chaîne de longueur nulle.
count a une valeur de 0	Une copie d'expression.

Notes

La valeur renvoyée par la fonction Replace est une chaîne, une fois les substitutions effectuées, qui commence à la position spécifiée par l'argument start et se termine à la fin de la chaîne expression. Elle n'est pas une copie de la chaîne d'origine du début à la fin.

L'exemple ci-dessous utilise la fonction Replace pour renvoyer une chaîne :

Dim MyString
MyString = Replace("XXpXXPXXp", "p", "Y")	' Comparaison binaire commençant 
							' au début de la chaîne. Renvoie "XXYXXPXXY". 
MyString = Replace("XXpXXPXXp", "p", "Y",	' Comparaison textuelle commençant à la position 3. 
							' Renvoie "YXXYXXY". 3, -1, 1) 

---