System.SysUtils.StringReplace

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

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 ne fait pas la distinction majuscules/minuscules ; sinon la casse est importante. 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 UnicodeString. Pour travailler avec les variables AnsiString, utilisez la fonction System.AnsiStrings.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