System.StrUtils.AnsiReplaceStr

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function AnsiReplaceStr(const AText, AFromText, AToText: string): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall AnsiReplaceStr(const System::UnicodeString AText, const System::UnicodeString AFromText, const System::UnicodeString AToText)/* overload */;

Eigenschaften

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

Beschreibung

Ersetzt unter Berücksichtigung der Groß-/Kleinschreibung alle Vorkommen eines Teilstrings in einem String.

Mit AnsiReplaceStr ersetzen Sie alle Vorkommen des Teilstrings AFromText im String AText durch den String AToText. AnsiReplaceStr gibt den String nach der Ersetzung zurück.

Mit ReplaceStr führen Sie die Ersetzung ohne Berücksichtigung der Groß-/Kleinschreibung durch.

Anmerkung:  Das Präfix Ansi im Funktionsnamen ist nur aus Gründen der Abwärtskompatibilität vorhanden. Diese Funktion ist jedoch für UnicodeString-Variablen entwickelt. Um die Ersetzung in einem AnsiString-Kontext auszuführen, verwenden Sie die Funktion ReplaceStr. In einem WideString-Kontext verwenden Sie zum Ersetzen die Funktion WideReplaceStr.

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

ReplaceStr ist dieselbe Funktion wie AnsiReplaceStr. In Anwendungen sollten Sie ReplaceStr verwenden, um Verwechslungen wegen des Präfix Ansi zu vermeiden.

Die Funktion StringReplace ist eine eher allgemeine Ersetzungsroutine mit der Option zur Berücksichtigung der Groß-/Kleinschreibung und der Möglichkeit, zu entscheiden, ob alle oder nur das erste Vorkommen des Teilstrings in dem String ersetzt werden soll.

Siehe auch