System.AnsiStrings.StringReplace

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi