System.AnsiStrings.ReplaceStr
Delphi
function ReplaceStr(const AText, AFromText, AToText: AnsiString): AnsiString;
C++
extern DELPHI_PACKAGE System::AnsiString __fastcall ReplaceStr(const System::AnsiString AText, const System::AnsiString AFromText, const System::AnsiString AToText)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.AnsiStrings.pas System.AnsiStrings.hpp |
System.AnsiStrings | System.AnsiStrings |
Description
Remplace toutes les occurrences d'une sous-chaîne au sein d'une chaîne, avec sensibilité à la casse.
Utilisez ReplaceStr pour remplacer toutes les occurrences de la sous-chaîne AFromText par la chaîne AToText, au sein de la chaîne AText. ReplaceStr renvoie la chaîne obtenue après le remplacement.
Utilisez System.AnsiStrings.ReplaceText pour effectuer un remplacement qui ne tient pas compte de la casse.
Remarque : Les paramètres et les valeurs de retour ont le type AnsiString. Pour effectuer le remplacement dans un contexte UnicodeString, utilisez la fonction System.StrUtils.ReplaceStr. De même, pour effectuer le remplacement dans un contexte WideString, utilisez la fonction WideReplaceStr.
Remarque : Le remplacement récursif des sous-chaînes n'est pas pris en charge. Cela signifie que, si la substitution de AToText aboutit à une nouvelle correspondance pour AFromText, cette correspondance n'est pas remplacée.
ReplaceStr est équivalente à la fonction AnsiReplaceStr.
La fonction StringReplace est une routine de remplacement plus générale, donnant des options sensibles à la casse, ainsi qu'une option permettant de décider si toutes les occurrences de la sous-chaîne dans la chaîne seront remplacées, ou si seulement la première occurrence sera remplacée.