System.SysUtils.StringReplace

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function StringReplace(const Source, OldPattern, NewPattern: string; Flags: TReplaceFlags): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall StringReplace(const System::UnicodeString Source, const System::UnicodeString OldPattern, const System::UnicodeString NewPattern, TReplaceFlags Flags)/* overload */;

Eigenschaften

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


Beschreibung

Ersetzt Vorkommen eines Teilstrings in einem String.

StringReplace ersetzt im String Source 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 ohne Berücksichtigung der Groß-/Kleinschreibung durchgeführt, ansonsten ist die Groß-/Kleinschreibung wichtig. Wenn rfReplaceAll aktiviert ist, werden alle Vorkommen von OldPattern ersetzt; ansonsten nur das erste Vorkommen.

Hinweis: Diese Funktion ist für UnicodeString-Variablen entwickelt. Um AnsiString-Variablen zu benutzen, verwenden Sie die System.AnsiStrings.StringReplace-Funktion. Um WideString-Variablen zu benutzen, verwenden Sie die System.WideStrUtils.WideStringReplace-Funktion.

Hinweis: 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 ReplaceStr (mit Berücksichtigung der Groß-/Kleinschreibung) oder ReplaceText (ohne Berücksichtigung der Groß-/Kleinschreibung) verwenden.

Siehe auch