StrReplace

Ersetzt eine bestimmte Teilzeichenkette mit einer neuen Zeichenkette.

ErsetzteZkette := StrReplace(Heuhaufen, Nadel , ErsatzText, GroßKleinSensitiv, &AusgabeVarAnzahl, Limit)

Parameter

Heuhaufen

Typ: Zeichenkette

Die Zeichenkette, die durchsucht und ersetzt werden soll.

Nadel

Typ: Zeichenkette

Die Zeichenkette, nach der gesucht werden soll.

ErsatzText

Typ: Zeichenkette

Wenn leer oder weggelassen, wird Nadel mit einer leeren Zeichenkette ersetzt, d.h. es wird im Rückgabewert weggelassen. Andernfalls geben Sie die Zeichenkette an, mit der Nadel ersetzt werden soll.

GroßKleinSensitiv

Typ: Zeichenkette oder Integer (boolesch)

Wenn weggelassen, wird standardmäßig Off verwendet. Andernfalls geben Sie einen der folgenden Werte an:

On oder 1 (true): Die Suche erfolgt Groß-/Kleinschreibung-sensitiv.

Off oder 0 (false): Die Suche erfolgt nicht Groß-/Kleinschreibung-sensitiv, d.h. die Großbuchstaben A bis Z und die entsprechenden Kleinbuchstaben werden als identisch betrachtet.

Locale: Die Suche erfolgt nicht Groß-/Kleinschreibung-sensitiv, gemäß den Regeln der aktuellen Sprach- und Regionseinstellungen des Benutzers. Zum Beispiel behandeln die meisten englischen und westeuropäischen Sprach- und Regionseinstellungen die Großbuchstaben A bis Z, einschließlich ASCII-fremde Großbuchstaben wie Ä und Ü, und die entsprechenden Kleinbuchstaben als identisch. Locale ist 1- bis 8-mal langsamer als Off, abhängig von den zu vergleichenden Zeichenketten.

&AusgabeVarAnzahl

Typ: VarRef

Wenn weggelassen, wird der zugehörige Wert nicht gespeichert. Andernfalls geben Sie eine Referenz an, die auf eine Ausgabevariable verweist, in der die Anzahl der erfolgten Ersetzungen gespeichert werden soll (andernfalls 0).

Limit

Typ: Integer

Wenn weggelassen, wird standardmäßig -1 verwendet, wodurch alle Vorkommen in Heuhaufen ersetzt werden. Andernfalls geben Sie die maximal zulässige Anzahl von Ersetzungen an. Der Heuhaufen-Bereich rechts neben der letzten Ersetzung bleibt unverändert.

Rückgabewert

Typ: Zeichenkette

Diese Funktion gibt die ersetzte Version der angegebenen Zeichenkette zurück.

Bemerkungen

Die internen Variablen A_Space und A_Tab enthalten ein Leer- bzw. Tabulatorzeichen. Sie sind nützlich, um nach Leer- und Tabulatorzeichen zu suchen, die entweder einzeln oder am Anfang oder Ende von Nadel vorkommen.

RegExReplace, InStr, SubStr, StrLen, StrLower, StrUpper

Beispiele

Entfernt alle Wagenrücklauf-Zeilenvorschub-Paare (`r`n) aus der Zwischenablage.

A_Clipboard := StrReplace(A_Clipboard, "`r`n")

Ersetzt jedes Leerzeichen mit einem Pluszeichen.

NeueZkette := StrReplace(AlteZkette, A_Space, "+")

Entfernt alle leeren Zeilen aus dem Text einer Variable.

Loop
{
    MeineZkette := StrReplace(MeineZkette, "`r`n`r`n", "`r`n",, &Anzahl)
    if (Anzahl = 0)  ; Keine weiteren Ersetzungen erforderlich.
        break
}