Retourne une chaîne de type String 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.
Syntaxe
Replace( expression, find, replace [, start ] [, count ] [, compare ] )
La syntaxe de la fonction Replace contient les arguments suivants :
|
Argument |
Description |
|
expression |
Obligatoire. Expression de chaîne contenant la sous-chaîne à remplacer. |
|
rechercher |
Obligatoire. Sous-chaîne recherchée. |
|
remplacer |
Obligatoire. Sous-chaîne de remplacement. |
|
début |
Facultatif. Position dans l’expression où la recherche de sous-chaîne doit commencer. En cas d’omission, 1 est supposé. |
|
count |
Facultatif. Nombre de substitutions de sous-chaînes à effectuer. En cas d’omission, la valeur par défaut est –1, ce qui signifie que toutes les substitutions sont possibles. |
|
comparaison |
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. |
Paramètres
L’argument compare peut avoir les valeurs suivantes :
|
Constante |
Valeur |
Description |
|
vbUseCompareOption |
–1 |
Effectue une comparaison à l’aide du paramètre de l’instruction Option Compare . |
|
vbBinaryCompare |
0 |
Effectue une comparaison binaire. |
|
vbTextCompare |
1 |
Effectue une comparaison textuelle. |
|
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 uniquement. Effectue une comparaison basée sur les informations de votre base de données. |
Valeurs de retour
Replace retourne les valeurs suivantes :
|
Si |
Replace retourne |
|
expression est de longueur nulle |
Chaîne de longueur nulle (« ») |
|
expression est Null |
Erreur. |
|
find est de longueur nulle |
Copie de l’expression. |
|
replace est de longueur nulle |
Copie de l’expression avec toutes les occurrences de la recherche supprimées. |
|
start > Len(expression) |
Chaîne de longueur nulle. Le remplacement de chaîne commence à la position indiquée par start. |
|
count est 0 |
Copie de l’expression. |
Notes
La valeur de retour de la fonction Replace est une chaîne, avec substitutions effectuées, 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 ; |
Retourne le « ProductID », recherche « PRO » dans « ProductID » et remplace par « Product » et affiche le résultat dans la colonne ReplacedID. |
