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.