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.
Syntaxe
Replace(expression, find, replace [, start ] [, count ] [, compare ] )
La syntaxe de la fonction Remplacer 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. |
| de démarrage | Facultatif. Position dans l’expression où la recherche de sous-chaîne doit commencer. Si cette option est omise, 1 est supposé. |
| nombre | Facultatif. Nombre de substitutions de sous-chaînes à effectuer. Si elle est omise, la valeur par défaut est –1, ce qui signifie effectuer toutes les substitutions 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 de comparaison peut avoir les valeurs suivantes :
| Constante | Valeur | Description |
|---|---|---|
| vbUseCompareOption | –1 | Effectue une comparaison en utilisant le 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 en fonction des informations disponibles dans votre base de données. |
Valeurs de retour
Remplacer renvoie les valeurs suivantes :
| Si | Remplacer les retours |
|---|---|
| expression est de longueur nulle | Chaîne nulle (« ») |
| expression is Null | Une erreur. |
| find is zero-length | Copie de l’expression. |
| replace is zero-length | Copie de l’expression avec toutes les occurrences de recherche supprimées. |
| de démarrage>NbCar (expression) | Chaîne nulle. Le remplacement des chaînes commence à la position indiquée par start. |
| count is 0 | Copie de l’expression. |
Remarques
La valeur de retour de la fonction Remplacer est une chaîne, avec des substitutions effectuées, qui commence à la position spécifiée par start et se termine à la fin de la chaîne d’expression . Ce n’est pas une copie de la chaîne originale du début à la fin.
Exemple
| Expression | Résultats |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO »,"Product ») AS ReplacementID FROM ProductSales ; | Renvoie le « ProductID », recherche « PRO » dans « ProductID » et le remplace par « Product » et affiche le résultat dans la colonne ReplacementID. |