ReplaceString

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
                             (und auch nirgends zugewiesen - da es der als Parameter übergebene 'String$' ist,
                             der geändert wird).
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
  Debug ReplaceString("Hello again, hello again", "HELLO", "oh no...", #PB_String_NoCase, 10) ; wird "Hello again, oh no... again" anzeigen
  
  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

Siehe auch

RemoveString(), InsertString()

Unterstützte OS

Alle

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

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 (und auch nirgends zugewiesen - da es der als Parameter übergebene 'String$' ist, der geändert wird).
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.