Beschreibung
Gibt eine Zeichenfolge zurück, in der eine festgelegte, untergeordnete Zeichenfolge mit einer festgelegten Häufigkeit durch eine andere untergeordnete Zeichenfolge ersetzt wurde.
Syntax
Replace(expression, find, replace[, start[, count[, compare]]])
Die Syntax der Replace-Funktion besteht aus folgenden Teilen:
Teil | Beschreibung |
---|---|
expression | Erforderlich. Zeichenfolgenausdruck, der die zu ersetzende, untergeordnete Zeichenfolge enthält. |
find | Erforderlich. Die untergeordnete Zeichenfolge, nach der gesucht wird. |
replace | Erforderlich. Die untergeordnete Ersatzzeichenfolge. |
start | Optional. Position in expression, an der die Suche nach der untergeordneten Zeichenfolge beginnt. Wird diese Angabe ausgelassen, wird bei 1 begonnen. |
count | Optional. Anzahl der durchzuführenden Ersetzungen der untergeordneten Zeichenfolge. Wird diese Angabe ausgelassen, ist die Standardeinstellung –1, d.h. alle möglichen Zeichenfolgen werden ersetzt. |
compare | Optional. Numerischer Wert, der die Art des Vergleichs angibt, der beim Beurteilen von untergeordneten Zeichenketten verwendet werden soll. Werte finden Sie im Abschnitt Einstellungen. |
Einstellungen
Das Argument compare kann folgende Werte haben:
Konstante | Wert | Beschreibung |
---|---|---|
vbUseCompareOption | –1 | Führt einen Vergleich unter Verwendung der Option Compare-Anweisung durch. |
vbBinaryCompare | 0 | Führt einen binären Vergleich durch. |
vbTextCompare | 1 | Führt einen Textvergleich durch. |
vbDatabaseCompare | 2 | Nur Microsoft Access. Führt einen Vergleich anhand der Informationen in Ihrer Datenbank durch. |
Rückgabewerte
Replace gibt folgende Werte zurück:
Wenn | gibt Replace folgendes zurück |
---|---|
expression die Länge Null hat | Eine Zeichenfolge der Länge Null ("") |
expression Null ist | Einen Fehler. |
find die Länge Null hat | Eine Kopie von expression. |
replace die Länge Null hat | Eine Kopie von expression, aus dem alle Vorkommnisse von suchen entfernt wurden. |
start > Len(expression) | Eine Zeichenfolge der Länge Null. |
count 0 ist | Eine Kopie von expression. |
Anmerkungen
Der Rückgabewert der Replace-Funktion ist eine Zeichenfolge, bei der Ersetzungen durchgeführt wurde, die an der von start festgelegten Position beginnt, und die am Ende der Zeichenfolge expression endet. Er stellt von Anfang bis Ende keine Kopie der Originalzeichenfolge dar.