Gibt eine Zeichenfolge zurück, in der eine angegebene Teilzeichenfolge so oft wie angegeben durch eine andere Teilzeichenfolge ersetzt wurde.
Syntax
Replace(expression, find, replace [, start ] [, count ] [, compare ] )
Die Syntax der Funktion Replace weist die folgenden Argumente auf:
| Argument | Beschreibung |
|---|---|
| Ausdruck | Erforderlich. Zeichenfolgenausdruck, der die zu ersetzende, Teilzeichenfolge enthält. |
| Suchzeichenfolge | Erforderlich. Die Teilzeichenfolge, nach der gesucht wird. |
| Ersatzzeichenfolge | Erforderlich. Ersatzzeichenfolge für die Teilzeichenfolge. |
| Startwert | Optional. Position innerhalb des Ausdrucks , an der die Teilzeichenfolgensuche beginnen soll. Fehlt dieses Argument, wird 1 angenommen. |
| Anzahl | Optional. Anzahl der durchzuführenden Ersetzungen der Teilzeichenfolge. Wird diese Angabe ausgelassen, ist die Standardeinstellung –1, d. h., alle möglichen Zeichenfolgen werden ersetzt. |
| Vergleich | Optional. Numerischer Wert, der die Art des Vergleichs angibt, der bei der Auswertung von Teilzeichenfolgen zu verwenden ist. Die erforderlichen Werte finden Sie im Abschnitt "Einstellungen". |
Einstellungen
Das compare-Argument kann die folgenden Werte aufweisen:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbUseCompareOption | –1 | Verwendet für einen Vergleich die Einstellung der Option Compare-Anweisung. |
| vbBinaryCompare | 0 | Führt einen binären Vergleich durch. |
| vbTextCompare | 1 | Führt einen Textvergleich durch. |
| vbDatabaseCompare | 2 | Nur Microsoft Office Access 2007. Führt einen Vergleich anhand der Informationen in Ihrer Datenbank durch. |
Rückgabewerte
Replace gibt die folgenden Werte zurück:
| Bedingung | Rückgabewert |
|---|---|
| Ausdruck hat eine Länge von 0 (null) | Zeichenfolge der Länge 0 (Null) ("") |
| Ausdruck ist Null | Fehler. |
| "find " ist mit der Länge 0 (null) | Kopie des Ausdrucks. |
| replace ist eine Länge von 0 (null) | Kopie des Ausdrucks , wobei alle Vorkommen von "find " entfernt wurden. |
| Starten>Len(Ausdruck) | Zeichenfolge der Länge 0 (Null). Die Zeichenfolgenersetzung beginnt an der durch Start angegebenen Position. |
| Count ist 0 | Kopie des Ausdrucks. |
Hinweise
Der Rückgabewert der Replace-Funktion ist eine Zeichenfolge mit Ersetzungen, die an der durch start angegebenen Position beginnt und am Ende der Ausdruckszeichenfolge endet. Es ist keine Kopie der ursprünglichen Zeichenfolge von Anfang bis Ende.
Beispiel
| Ausdruck | Ergebnisse |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplaceID FROM ProductSales; | Gibt die "ProductID" zurück, sucht "PRO" in "ProductID" und ersetzt durch "Product" und zeigt das Ergebnis in der Spalte ReplaceID an. |