ReplaceString()

Syntaxe

Resultat$ = ReplaceString(Chaine$, ChaineCherchee$, ChaineRemplacee$ [, Mode [, PositionDepart [, NbOccurences]]])
Description
Remplace une sous-chaîne par une autre.

Arguments

Chaine$ La chaîne de caractères à utiliser.
ChaineCherchee$ La chaîne de caractères à substituée.
ChaineRemplacee$ La chaîne de caractères de remplacement.
Mode (optionnel) Peut être une combinaison des valeurs suivantes:
  #PB_String_CaseSensitive : La suppression est sensible à la casse (A<>a). Par défaut.
  #PB_String_NoCase : Recherche les occurrences sans tenir compte de la casse (A=a). 
  #PB_String_InPlace: Remplacement direct dans la Chaîne de caractères initiale 'Chaîne$'. Dans ce cas,
                      'ChaineRemplacee$' doit absolument avoir la même taille que 'ChaineCherchee$'.
                      C'est une fonctionnalité pour programmeurs expérimentés qui ont besoin d'une fonction
                      extrêmement rapide pour ce cas particulier. Quand cette option est utilisée, le résultat renvoyé par ReplaceString() doit être
                      ignoré (car c'est la chaîne de caractères passée en paramètre qui est modifiée).
PositionDepart (optionnel) Permet de spécifier à partir de quel caractère le remplacement doit être effectué.

Sa valeur minimale est 1.
NbOccurences (optionnel) Le remplacement s'arrêtera une fois 'NbOccurences' atteint.

Valeur de retour

Renvoie un chaîne dont toutes les occurrences 'ChaineCherchee$' ont été substituées par 'ChaineRemplacee$'.

Exemple

  Debug ReplaceString("deviser de l'Art", " de", " sur") ; Affichera "deviser sur l'Art"
  Debug ReplaceString("Salut les gens, Salut les gens", "SALUT", "ho non...", #PB_String_NoCase, 10) ; Affichera "Salut les gens, ho non... les gens"
  
  test$ = "Bundy, Barbie, Buddy"
  ReplaceString(test$, "B", "Z", #PB_String_InPlace, 1)  ; Tous les B seront remplacés par des Z  (Dans ce mode la chaîne de caractères passée en paramètre est modifiée)
  Debug test$   ; Affichera la chaîne de caractères modifiée.

Voir aussi

CountString(), FindString(), InsertString(), RemoveString(), ReverseString(), StringByteLength(), StringField()

OS Supportés

Tous

<- RemoveString() - String Index - ReverseString() ->