System.WideStrUtils.WideReplaceStr

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

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

C++

extern DELPHI_PACKAGE System::WideString __fastcall WideReplaceStr(const System::WideString AText, const System::WideString AFromText, const System::WideString AToText);

プロパティ

種類 可視性 ソース ユニット
function public
System.WideStrUtils.pas
System.WideStrUtils.hpp
System.WideStrUtils System.WideStrUtils


説明

大文字と小文字を区別しながら検索して、文字列内に出現する指定の部分文字列をすべて指定の文字列に置き換えます。

WideReplaceStr を使用すると、文字列 AText 内に出現する部分文字列 AFromText をすべて、文字列 AToText に置き換えることができます。 WideReplaceStr は、置換の結果として得られた文字列を返します。

大文字と小文字を区別しないで置換を行う場合は、WideReplaceText を使用します。

メモ: この関数は、WideString 変数用に設計されています。 AnsiString 変数を処理するには、System.AnsiStrings.StringReplace 関数を使用します。 UnicodeString 変数を処理するには、System.SysUtils.StringReplace 関数を使用します。

メモ: 部分文字列の再帰的置換はサポートされていません。 つまり、AToText へ置換した結果、AFromText に一致する部分が新たに出現しても、その一致部分は置換されません。

WideStringReplace 関数はより一般的な置換ルーチンで、大文字と小文字の区別に関するオプションのほか、文字列内に出現するすべての部分文字列を置換するのか、それとも最初に出現したものだけを置換するのかを指定するオプションも用意されています。

関連項目