System.SysUtils.StringReplace

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

Delphi

function StringReplace(const Source, OldPattern, NewPattern: string; Flags: TReplaceFlags): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall StringReplace(const System::UnicodeString Source, const System::UnicodeString OldPattern, const System::UnicodeString NewPattern, TReplaceFlags Flags)/* overload */;

プロパティ

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


説明

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

StringReplace は、OldPattern で指定される部分文字列を、文字列 Source 内の NewPattern で指定される部分文字列に置換します。

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

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

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

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

関連項目