RAD Studio VCL Reference
WideStrUtils.WideReplaceStr Function

Replaces all occurrences of a substring within a string, using case-sensitive search.

function WideReplaceStr(const AText: WideString; const AFromText: WideString; const AToText: WideString): WideString;
BSTR WideReplaceStr(const BSTR AText, const BSTR AFromText, const BSTR AToText);

Use WideReplaceStr to replace all occurrences of the substring AFromText with the string AToText, within the string AText. WideReplaceStr returns the string obtained after replacement.  

Use WideReplaceText to do a case-insensitive replacement.

Note: Both the parameters and the return value are of type WideString. To do the replacement in a UnicodeString context, use the ReplaceStr function. Also, to do the replacement in an AnsiString context, use the ReplaceStr function.
Note: Recursive replacement of substrings is not supported. This means that if the substitution of AToText results in a new match for AFromText, that match is not replaced.
The WideStringReplace function is a more general replacement routine, giving case-sensitivity options, as well as the option to decide whether to replace all occurrences or the first occurrence of the substring in the string. 


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!