System.WideStrUtils.WideStringReplace

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function WideStringReplace(const S, OldPattern, NewPattern: Widestring; const Flags: TReplaceFlags): Widestring;

C++

extern DELPHI_PACKAGE System::WideString __fastcall WideStringReplace(const System::WideString S, const System::WideString OldPattern, const System::WideString NewPattern, const System::Sysutils::TReplaceFlags Flags);

Propriétés

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

Description

Remplace les occurrences d'une sous-chaîne au sein d'une chaîne.

WideStringReplace 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 WideString. Pour travailler avec les variables AnsiString, utilisez la fonction System.AnsiStrings.StringReplace function. Pour travailler avec les variables UnicodeString, utilisez la fonction System.SysUtils.StringReplace.

Remarque :  Le remplacement récursif des sous-chaînes n'est pas supporté. 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 WideReplaceStr pour effectuer une recherche sensible à la casse, ou WideReplaceText pour une recherche insensible à la casse.

Voir aussi