Description
Replace renvoie une chaîne dans laquelle la sous-chaîne spécifiée a été remplacée par une autre sous-chaîne un certain nombre de fois.
Syntaxes des arguments
Replace (chaîneEntrée, chaîneRecherche, chaîneRemplacement)
Replace (chaîneEntrée, chaîneRecherche, chaîneRemplacement, positionDébut)
Replace (chaîneEntrée, chaîneRecherche, chaîneRemplacement, positionDébut, compte)
Replace (chaîneEntrée, chaîneRechercher, chaîneRemplacement, positionDébut, compte, comparer)
Arguments
"chaîneEntrée" est une chaîne contenant la sous-chaîne à remplacer.
"chaîneRecherche" est une sous-chaîne à rechercher.
"chaîneRemplacement" est la sous-chaîne de remplacement.
"positionDébut" est un nombre facultatif indiquant le point de départ de la recherche dans "chaîneEntrée". Si omis, la valeur 1 est utilisée par défaut.
"compte" est un nombre facultatif des substitutions de sous-chaînes à réaliser. Si cet argument est omis, la valeur par défaut est –1, ce qui signifie que toutes les substitutions possibles sont effectuées.
"comparer" est un argument facultatif indiquant le type de comparaison à effectuer lors de l'évaluation des sous-chaînes :
0 effectue une comparaison qui respecte la casse.
1 effectue une comparaison qui ne respecte pas la casse.
Si cet argument est omis, la fonction effectue une comparaison qui respecte la casse.
Résultat
Valeur de type chaîne
Action
Replace renvoie une chaîne dans laquelle la sous-chaîne spécifiée a été remplacée par une autre sous-chaîne un certain nombre de fois. Facultativement, vous pouvez également spécifier le point de départ du remplacement et renvoyer une chaîne commençant à ce point.
Exemple d'utilisation
Pour remplacer systématiquement une sous-chaîne par une autre dans une chaîne.
Exemples
Les exemples suivants supposent que "chaîneEntrée" est la chaîne de texte suivante : "Je ne serai pas là lundi. Pouvons-nous nous rencontrer lundi prochain ?".
Replace (inputString, "Monday", "Wednesday")
Renvoie "Je ne serai pas là mercredi. Pouvons-nous nous rencontrer mercredi prochain ?".
Replace (inputString, "Monday", "Wednesday", 23)
Renvoie "Pouvons-nous nous rencontrer mercredi prochain ?". Le remplacement commence à partir du 27ème caractère en partant du début de "chaîneEntrée" initiale. La chaîne renvoyée correspond à cette portion de chaîne où la substitution a été effectuée.
Replace (inputString, "Monday", "Wednesday", 1, 1)
Renvoie "Je ne serai pas là mercredi. Pouvons-nous nous rencontrer lundi prochain ?". Il y a un seul remplacement en partant du 1er caractère de la "chaîneEntrée" initiale. La chaîne renvoyée correspond donc à la chaîne initiale où une seule substitution a été effectuée.
Replace (inputString, "monday", "Wednesday", 1, -1, 0)
Renvoie la même "chaîneEntrée" sans aucune modification car aucune correspondance n'a été trouvée pour "Lundi" avec une majuscule.
Replace (inputString, "monday", "Wednesday", 1, -1, 1)
Renvoie "chaîneEntrée" avec les deux occurrences de "lundi" remplacées par "mercredi". C'est à dire : "Je ne serai pas là mercredi. Pouvons-nous nous rencontrer mercredi prochain ?".
Commentaires
La valeur renvoyée par la fonction Replace est une chaîne, où les remplacements de sous-chaînes ont été effectués, commençant au point de départ spécifié par "positionDébut" et terminant à la fin de la chaîne "chaîneEntrée". Il ne s'agit pas d'une copie de la chaîne initiale du début à la fin.