System.StrUtils.AnsiReplaceStr

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

Delphi

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

C++

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

プロパティ

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


説明

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

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

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

メモ: 関数名の先頭の Ansi は、下位互換性のためだけに付いています。 しかし、この関数は、UnicodeString 変数用に設計されています。 AnsiString 変数を処理するには、System.AnsiStrings.StringReplace 関数を使用します。 WideString 変数を処理するには、System.WideStrUtils.WideStringReplace 関数を使用します。

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

ReplaceStr は、AnsiReplaceStr と同じ関数です。 アプリケーションを作成する際は、Ansi 接頭辞に起因する混乱を避けるために、ReplaceStr を使用することをお勧めします。

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

関連項目