Renvoie une chaîne dans laquelle un sous-chaîne spécifié a été remplacé par un autre sous-chaîne le nombre de fois spécifié.
Syntaxe
Remplacer( expression, rechercher, remplacer [ ,début ] [ ,compte ] [ ,comparer ] )
La syntaxe de la fonction Remplacer compte les arguments suivantes :
Argument |
Description |
expression |
Obligatoire. Expression de chaîne contenant un sous-chaîne à remplacer. |
rechercher |
Obligatoire. Sous-stration de recherche. |
remplacer |
Obligatoire. Sous-stration de remplacement. |
début |
Facultatif. Position dans l’expression où la recherche substration doit commencer. En cas d’omis, 1 est pris en charge. |
count |
Facultatif. Nombre de sous-strations de substitution à effectuer. Si cet paramètre est omis, la valeur par défaut est –1, ce qui signifie que tous les substitutions sont possibles. |
comparaison |
Facultatif. Valeur numérique indiquant le type de comparaison à utiliser lors de l’évaluation des sous-chaînes. Voir la section Paramètres pour les valeurs. |
Paramètres
L’argument comparaison peut avoir les valeurs suivantes :
Constante |
Valeur |
Description |
vbUseCompareOption |
–1 |
Effectue une comparaison en utilisant le paramètre de l’instruction Comparaison des options. |
vbBinaryCompare |
0 |
Effectue une comparaison binaire. |
vbTextCompare |
1 |
Effectue une comparaison textuelle. |
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 uniquement. Effectue une comparaison sur la base d’informations de votre base de données. |
Renvoyer des valeurs
Remplacer renvoie les valeurs suivantes :
Si |
Remplacer les retours |
expression n’est pas longue |
Chaîne nulle (« ») |
expression est Null |
Une erreur. |
recherche est nulle |
Copie de l’expression. |
remplacer est de longueur nulle |
Copie de l’expression avec toutes les occurences de la recherche supprimée. |
start > Len(expression) |
Chaîne nulle. Le remplacement de chaîne commence à la position indiquée par le début. |
compte est de 0 |
Copie de l’expression. |
Remarques
La valeur de retour de la fonction Remplacer est une chaîne, avec remplacements effectués, qui commence à la position spécifiée par début et se termine à la fin de la chaîne d’expression. Il ne s’agit pas d’une copie de la chaîne d’origine, du début à la fin.
Exemple
Expression |
Résultats |
SELECT ProductID, Replace(ProductID,"PRO »,"Product ») AS ReplacedID FROM ProductSales; |
Renvoie « ProductID », trouve « PRO » dans « ProductID » et remplace par « Product » et affiche le résultat dans la colonne ReplacedID. |