Replace

betrifft

Die Replace-Funktion gibt eine Zeichenfolge zurück, in der eine festgelegte, untergeordnete Zeichenfolge mit einer festgelegten Häufigkeit durch eine andere untergeordnete Zeichenfolge ersetzt wird.

 

Syntax

Replace(Expr, SearchFor, ReplaceBy [, BeginAt [, Count [, Compare]]])

Rückgabewert

Typ

Beschreibung

String

Das Ergebnis der String-Ersetzung

Parameter

Verwendung

Name

Typ

Übergabe

Beschreibung

Erforderlich

Expr

String

ByVal

String, dessen Inhalt teilweise ersetzt werden soll

Erforderlich

SearchFor

String

ByVal

Teilzeichenfolge, die ersetzt werden soll

Erforderlich

ReplaceBy

String

ByVal

Die Ersetzungszeichenfolge

Optional

BeginAt

Long

ByVal

Die Stelle in SearchFor, ab dem die Ersetzung erfolgen soll

Optional

Count

Variant

ByVal

Die Zahl der gewünschten Ersetzungen. Ist Count nicht angegeben, werden alle Vorkommnisse ersetzt

Optional

Compare

StrCompOption

ByVal

Art des Vergleichs, um eine Ersetzungsstelle zu ermitteln

 

Mögliche Rückgabewerte können sein:

 

Rückgabe

Beschreibung

""

Expr ist ein Leerstring oder BeginAt > Length(Expr)

Expr

SearchFor ist ein Leerstring oder Count ist 0

 

StrCompOption

Beschreibung

0

Binärer Vergleich

1

Textbasierter Vergleich (Groß- und Kleinschreibung werden nicht berücksichtigt)

 

Mit dem Parameter Expr wird die Zeichenfolge übergeben, die die zu ersetzende, untergeordnete Zeichenfolge enthält.

SearchFor enthält die untergeordnete Zeichenfolge, nach der Expr durchsucht wird.

ReplaceBy stellt die untergeordnete Ersatzzeichenfolge dar.

Wird der Parameter BeginAt weggelassen, beginnt die Suche immer ab der ersten Stelle. Möchte man die Suche ab einer anderen Position beginnen, muss dieser Parameter angegeben werden.

Wird der Parameter Count nicht definiert, werden alle gefundenen Zeichenfolgen in Expr ersetzt (Standardeinstellung; Count = -1). Geben Sie mit diesem Parameter an, wie viele gefundene Zeichenfolgen ersetzt werden sollen.

Über den Parameter Compare legen Sie die Art des Vergleichs fest.