StringReplace()

Ersetzt oder verändert bestimmte Teile einer angegebenen Zeichenfolge und gibt das Ergebnis zurück.

Kategorie

Zeichenfolge

Syntax

ZeichenfolgenErgebnis = StringReplace( Text, Suchtext, NeuerText, GrossKlein, Ersetzungen, GanzesWort );

Parameter

Text

Die Zeichenfolge, in der Zeichen, Wörter oder Sätze ersetzt werden. Tatsächliche Zeichenfolge oder ein Zeichenfolgen-Attribut.

Suchtext

Die Zeichenfolge, die gesucht und ersetzt werden soll. Tatsächliche Zeichenfolge oder ein Zeichenfolgen-Attribut.

NeuerText

Die Ersatz-Zeichenfolge. Tatsächliche Zeichenfolge oder ein Zeichenfolgen-Attribut.

GrossKlein

Bestimmt, ob die Groß-/Kleinschreibung bei der Suche beachtet werden soll. (0=Nein und 1=Ja) Beliebige Zahl oder ganzzahliges Attribut.

Ersetzungen

Gibt an, wie viele Vorkommen der Zeichenfolge ersetzt werden sollen Beliebige Zahl oder ein ganzzahliges Attribut. Zur Angabe aller Vorkommen, diesen Wert auf -1 setzen.

GanzesWort

Gibt an, ob nur ganze Wörter ersetzt werden sollen. (0=Nein und 1=Ja) Beliebige Zahl oder ganzzahliges Attribut. Wenn MatchWholeWords aktiviert (auf 1 gesetzt) und SearchFor auf „and“ gesetzt ist, wird das Vorkommen von „and“ in „Handle“ nicht ersetzt. Ist MatchWholeWords dagegen deaktiviert (auf 0 gesetzt), wird es ersetzt.

Anmerkungen

Diese Funktion verwenden, um Zeichen, Wörter oder Sätze innerhalb einer Zeichenfolge zu ersetzen.

Sonderzeichen, wie @ # $ % & * ( ), werden durch die Funktion StringReplace() nicht erkannt. Die Funktion betrachtet diese Zeichen als Trennzeichen. Wenn Sie beispielsweise StringReplace() mit den Werten (abc#,abc#,1234,0,1,1) ausführen, wird nichts ersetzt. Das #-Zeichen wird als Trennzeichen und nicht als eigenständiges Zeichen erkannt.

Beispiele

StringReplace("In From Within","In","Out",0,1,0) ' gibt "Out From Within" zurück (ersetzt nur das erste Vorkommen);

StringReplace("In From Within","In","Out",0,-1,0) ' gibt "Out From without" (ersetzt alle Vorkommen);

StringReplace("In From Within","In","Out",1,-1,0) ' gibt "Out From Within" zurück (ersetzt alle Vorkommen mit passender Groß-/Kleinschreibung);

StringReplace("In From Within","In","Out",0,-1,1) ' gibt "Out From Within" zurück (ersetzt alle ganzen Wörter);

Siehe auch:

StringASCII()

StringChar()

StringFromIntg()

StringFromReal()

StringFromTime()

StringInString()

StringLeft()

StringLen()

StringLower()

StringMid()

StringRight()

StringSpace()

StringTest()

StringToIntg()

StringToReal()

StringTrim()

StringUpper()

Text()