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. |
| Trouver | Obligatoire. Sous-chaîne recherchée. |
| Remplacer | Obligatoire. Sous-chaîne de remplacement. |
| Commencer | Facultatif. Position dans l’expression où la recherche de sous-chaîne doit commencer. En cas d’omission, 1 est supposé. |
| Compter | 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. |
| Commencer>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. |
Remarques
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. |