System.AnsiStrings.StringReplace
Delphi
function StringReplace(const Source, OldPattern, NewPattern: AnsiString;
Flags: TReplaceFlags): AnsiString;
C++
extern DELPHI_PACKAGE System::AnsiString __fastcall StringReplace(const System::AnsiString Source, const System::AnsiString OldPattern, const System::AnsiString NewPattern, System::Sysutils::TReplaceFlags Flags)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.AnsiStrings.pas System.AnsiStrings.hpp |
System.AnsiStrings | System.AnsiStrings |
Description
Remplace les occurrences d'une sous-chaîne au sein d'une chaîne.
StringReplace remplace les occurrences de la sous-chaîne spécifiée par OldPattern, par la sous-chaîne spécifiée par NewPattern au sein de la chaîne S.
Flags est un paramètre de type TReplaceFlags. Si rfIgnoreCase est défini, le remplacement est sensible à la casse ; sinon la casse est ignorée. Si rfReplaceAll est activé, toutes les occurrences de OldPattern sont remplacées ; sinon, seule la première occurrence est remplacée.
Remarque : Cette fonction est conçue pour les variables AnsiString. Pour travailler avec les variables UnicodeString, utilisez la fonction System.SysUtils.StringReplace. Pour travailler avec les variables WideString, utilisez la fonction System.WideStrUtils.WideStringReplace.
Remarque : Le remplacement récursif des sous-chaînes n'est pas pris en charge. Cela signifie que, si la substitution de OldPattern aboutit à une nouvelle correspondance pour NewPattern, cette correspondance n'est pas remplacée.
Pour remplacer toutes les occurrences de la sous-chaîne au sein de la chaîne, vous pouvez aussi utiliser la fonction ReplaceStr pour effectuer une recherche sensible à la casse, ou ReplaceText pour une recherche insensible à la casse.