System.WideStrUtils.WideStringReplace

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function WideStringReplace(const S, OldPattern, NewPattern: Widestring; const Flags: TReplaceFlags): Widestring;

C++

extern DELPHI_PACKAGE System::WideString __fastcall WideStringReplace(const System::WideString S, const System::WideString OldPattern, const System::WideString NewPattern, const System::Sysutils::TReplaceFlags Flags);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.WideStrUtils.pas
System.WideStrUtils.hpp
System.WideStrUtils System.WideStrUtils

Beschreibung

Ersetzt Vorkommen eines Teilstrings in einem String.

WideStringReplace ersetzt im String S die Vorkommen des in OldPattern angegebenen Teilstrings durch den in NewPattern angegebenen Teilstring.

Flags ist ein Parameter vom Typ TReplaceFlags. Wenn rfIgnoreCase gesetzt ist, wird die Ersetzung unter Berücksichtigung der Groß-/Kleinschreibung durchgeführt, ansonsten wird die Groß-/Kleinschreibung ignoriert. Wenn rfReplaceAll aktiviert ist, werden alle Vorkommen von OldPattern ersetzt; ansonsten nur das erste Vorkommen.

Anmerkung:  Diese Funktion ist für WideString-Variablen entwickelt. Um die Ersetzung in einem UnicodeString-Kontext auszuführen, verwenden Sie die Funktion StringReplace. Um die Ersetzung in einem AnsiString-Kontext auszuführen, verwenden Sie ebenfalls die Funktion StringReplace.

Anmerkung:  Das rekursive Ersetzen von Teilstrings wird nicht unterstützt. Das bedeutet Folgendes: Wenn die Ersetzung von OldPattern eine neue Übereinstimmung für NewPattern ergibt, wird diese Übereinstimmung nicht ersetzt.

Um alle Vorkommen des Teilstrings in dem String zu ersetzen, können Sie auch die Funktionen WideReplaceStr (mit Berücksichtigung der Groß-/Kleinschreibung) oder WideReplaceText (ohne Berücksichtigung der Groß-/Kleinschreibung) verwenden.

Siehe auch