System.WideStrUtils.WideStringReplace

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

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);

プロパティ

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


説明

文字列内に出現する部分文字列を置き換えます。

WideStringReplace は、文字列 S 内に出現する OldPattern で指定された部分文字列を、NewPattern で指定された部分文字列に置き換えます。

Flags は、TReplaceFlags 型のパラメータです。 rfIgnoreCase が設定されている場合は、大文字と小文字を区別して置換が行われ、設定されていない場合は、大文字と小文字の区別は無視されます。 rfReplaceAll が設定されている場合は、出現する OldPattern がすべて置き換えられ、設定されていない場合は、最初に出現するものだけが置き換えられます。

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

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

文字列内に出現する部分文字列をすべて置き換える場合は、WideReplaceStr 関数を使用して大文字と小文字を区別して検索することもできますし、WideReplaceText 関数を使用して大文字と小文字を区別せずに検索することもできます。

関連項目