Remplacer

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

Structure

Remplacer(expression, recherche, par[, début[, nombre[, comparaison]]])

Paramètres

expression - Obligatoire. Chaîne contenant la sous-chaîne à remplacer.

find - Obligatoire. Sous-chaîne recherchée.

replacewith - Obligatoire. Chaîne de remplacement.

début - Facultatif. Position dans l'expression à partir de laquelle la recherche de la sous-chaîne doit commencer. Si cette valeur n'est pas indiquée, la valeur par défaut est 1. Doit être utilisé avec la fonction count.

nombre - Facultatif. Nombre de remplacements de sous-chaînes à effectuer. Si ce paramètre est omis, la valeur par défaut est -1, ce qui signifie qu'il faut effectuer toutes les substitutions possibles. Doit être utilisé avec la commande « start ».

comparer - Facultatif. Valeur numérique indiquant le type de comparaison à utiliser lors de l'évaluation des sous-chaînes. Consultez la section « Paramètres » pour connaître les valeurs. Si ce paramètre n'est pas spécifié, la valeur par défaut est 0, ce qui signifie qu'une comparaison binaire est effectuée.

Valeurs des paramètres

L'argument « compare » peut prendre les valeurs suivantes :

Description de la valeur constante

vbBinaryCompare 0 Effectue une comparaison binaire.

vbTextCompare 1 Effectuer une comparaison textuelle.

Valeur de retour

La fonction Replace renvoie les valeurs suivantes :

Si la fonction Replace renvoie une chaîn

, l'expression est une chaîne de longueur nulle ('').

L'expression est nulle. Une erreur s'est produite.

La valeur trouvée est une copie de longueur nulle de l'expression.

replacewith est une copie de longueur nulle de l'expression, dont toutes les occurrences de find ont été supprimées.

début > Len(expression) Chaîne de longueur nulle.

Le nombre est égal à 0. Copie de l'expression.

Description

La fonction Replace renvoie une chaîne de caractères, dans laquelle les remplacements ont été effectués, qui commence à la position indiquée par start et se termine à la fin de la chaîne d'expression. Ce n'est pas une copie intégrale de la chaîne d'origine.

Exemple

L'exemple suivant utilise la fonction Replace pour renvoyer une chaîne de caractères :

Atténuer MyString

Une comparaison binaire commençant au début de la chaîne.

MyString = Replace("XXpXXPXXp", "p", "Y") ' Renvoie "XXYXXPXXY".

« Une comparaison textuelle à partir de la position 3. »

MyString = Replace("XXpXXPXXp", "p", "Y", 3, -1, 1) ' Renvoie « YXXYXXY ». |