ReplaceString()

Syntax

String$ = ReplaceString(String$, SuchString$, ErsatzString$ [, Modus [, StartPosition [, AnzVorkommen]]])
Beschreibung
Versucht alle Vorkommen des 'SuchString$' im angegebenen 'String$' zu finden und ersetzt diese mit dem 'ErsatzString$'.

Parameter

String$ Der zu verwendende String.
SuchString$ Der zu suchende String.
ErsatzString$ Der als Ersatz zu verwendende String.
Modus (optional) Dies kann eine Kombination der folgenden Werte sein: 
  #PB_String_CaseSensitive : Suchen/Ersetzen berücksichtigt Groß-/Kleinschreibung (a=a). (Standard)
  #PB_String_NoCase        : Suchen/Ersetzen unabhängig von Groß-/Kleinschreibung (A=a).
  #PB_String_InPlace       : "In place" (an Ort und Stelle) ersetzen. Dies bedeutet, dass der String direkt
                             im Speicher ersetzt wird. Der 'SuchString$' und der 'ErsatzString$' müssen die
                             gleiche Länge haben! Dies ist eine gefährliche Option, nur für fortgeschrittene
                             Anwender. Der Vorteil ist die sehr hohe Geschwindigkeit beim Ersetzen. Wenn diese
                             Option verwendet wird, muss das Ergebnis von ReplaceString() ignoriert werden. Nur
                             der als Parameter übergebene 'String$' wird verändert und stellt das Ergebnis dar.
                             Fixed (feste) Strings werden in diesem Modus nicht unterstützt.
StartPosition (optional) Gibt die Zeichenposition an, bei der das Ersetzen starten soll. Die Position des ersten Zeichens lautet 1. Wird diese weggelassen, dann wird der gesamte String verwendet.
AnzVorkommen (optional) Gibt an, wieviele Strings bis zum Anhalten der Operation ersetzt werden sollen. Wird dieser weggelassen, werden alle Strings ersetzt.

Rückgabewert

Ein neuer String mit den ersetzten Strings (siehe den #PB_String_InPlace Modus für ein abweichendes Verhalten).

Beispiel

  Debug ReplaceString("This is Art", " is", " was") ; wird "This was Art" anzeigen
  
  test$ = "Hello again, hello again"
  Result$ = ReplaceString(test$, "HELLO", "oh no...", #PB_String_NoCase, 10) ; wird "Hello again, oh no... again" anzeigen
  Debug Result$
  
  test$ = "Bundy, Barbie, Buddy"
  ReplaceString(test$, "B", "Z", #PB_String_InPlace, 1)  ; alle B werden in Z geändert (direkt im Speicher, es gibt hier keinen gültigen Rückgabewert)
  Debug test$   ; Ausgabe des geänderten Strings, wird "Zundy, Zarbie, Zuddy" ausgeben

Siehe auch

RemoveString(), InsertString()

Unterstützte OS

Alle

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