System.AnsiStrings.AnsiReplaceStr

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function AnsiReplaceStr(const AText, AFromText, AToText: AnsiString): AnsiString;

C++

extern DELPHI_PACKAGE System::AnsiString __fastcall AnsiReplaceStr(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 AnsiReplaceStr pour remplacer toutes les occurrences de la sous-chaîne AFromText par la chaîne AToText, au sein de la chaîne AText. AnsiReplaceStr renvoie la chaîne obtenue après le remplacement.

Utilisez AnsiReplaceText pour effectuer un remplacement qui ne tient pas compte de la casse.

Remarque :  Les paramètres et la valeur de retour ont le type AnsiString. Pour effectuer le remplacement dans un contexte UnicodeString, utilisez la fonction 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.

AnsiReplaceStr est équivalente à la fonction ReplaceStr.

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.

Voir aussi