StrUtils.AnsiReplaceStr

Informations Delphi

De StrUtils.pas

	function AnsiReplaceStr(const AText: string;
		const AFromText: string;
		const AToText: string): string; overload;

Unité : StrUtils

Type : fonction

Visibilité : public

Informations C++

De StrUtils.hpp

	System::UnicodeString __fastcall AnsiReplaceStr(System::UnicodeString AText, System::UnicodeString AFromText, System::UnicodeString AToText);

Unité : StrUtils

Type : fonction

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 ReplaceText pour effectuer un remplacement qui ne tient pas compte de la casse.

Remarque : Le préfixe Ansi apparaît dans le nom de la fonction uniquement à des fins de compatibilité descendante. Les paramètres et la valeur de retour sont de type string, qui est un alias de UnicodeString. Pour effectuer le remplacement dans un contexte AnsiString, 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.

ReplaceStr est équivalente à la fonction AnsiReplaceStr. Dans l'écriture de votre application, nous vous conseillons d'utiliser ReplaceStr, afin d'éviter toute confusion causée par le préfixe Ansi.

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.