System.AnsiStrings.StringReplace

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

Delphi

function StringReplace(const S, OldPattern, NewPattern: AnsiString; Flags: TReplaceFlags): AnsiString;

C++

extern DELPHI_PACKAGE System::AnsiString __fastcall StringReplace(const System::AnsiString S, const System::AnsiString OldPattern, const System::AnsiString NewPattern, System::Sysutils::TReplaceFlags Flags)/* overload */;

プロパティ

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


説明

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

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

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

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

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

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

関連項目