System.AnsiStrings.AnsiReplaceStr

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

Delphi

function AnsiReplaceStr(const AText, AFromText, AToText: AnsiString): AnsiString;

C++

extern DELPHI_PACKAGE System::AnsiString __fastcall AnsiReplaceStr(const System::AnsiString AText, const System::AnsiString AFromText, const System::AnsiString AToText)/* overload */;

プロパティ

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


説明

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

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

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

メモ: パラメータと戻り値はどちらも AnsiString 型です。 UnicodeString のコンテキストで置換を行う場合は、ReplaceStr 関数を使用してください。 また、WideString コンテキストで置換を行う場合は、WideReplaceStr 関数を使用します。

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

AnsiReplaceStr は、ReplaceStr と同じ関数です。

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

関連項目