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"

  test$ = "Salut les gens, Salut les gens"
  Resultat$ = ReplaceString(test$, "SALUT", "ho non...", #PB_String_NoCase, 10) ; Affichera "Salut les gens, ho non... les gens"
  Debug Resultat$
  
  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 "Zundy, Zarbie, Zuddy".

Voir aussi

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

OS Supportés

Tous

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