StringReplace() 関数

別の文字列で文字列を検索し、その文字列があった場合、別の文字列で置換します。以下の内容を指定できます。

• 大文字小文字の区別 - 大文字と小文字が同じ文字として扱われるかどうかを指定します。

• 置換するオカレンスの数 - 検索文字列のオカレンスが複数ある場合に役立ちます。

• 単語全体の一致 - 検索文字列が単語全体の場合に使用します。

  注意：この関数は、ダブル バイトの文字セットをサポートしていません。

構文

result = StringReplace (string, searchfor, replacewith, casesens, numtoreplace, matchwholewords)

パラメータ

string

検索が実行される文字列です。リテラル文字列、メッセージ型タグ変数、または文字列式です。

searchfor

検索対象の文字列です。リテラル文字列、メッセージ型タグ変数、または文字列式です。

replacewith

置換後の文字列です。リテラル文字列、メッセージ型タグ変数、または文字列式です。

casesens

検索で大文字と小文字を区別するかどうかを決定します。0 または 1、論理型タグ変数、またはブール式を指定できます。

0 - 大文字と小文字は区別されません（大文字と小文字は同じとみなされます）。

1 - 大文字と小文字は区別されます（大文字と小文字は別のものとみなされます）。

numtoreplace

実行する置換数です。-1 を設定すると、一致した検索文字列のすべてのオカレンスが置換されます。リテラル整数値、整数型タグ変数、または整数式です。

matchwholewords

完全に一致する単語だけを対象とするかどうかを決めます。0 または 1、論理型タグ変数、またはブール式を指定できます。

0 - 文字列の任意の場所で、検索文字列が検索されます。

1 - 完全に一致する単語だけが対象となります。

例

このステートメントは、最初のオカレンスのみを置換して、“MTY 030 MTX” を返します。

StringReplace("MTX 030 MTX","MTX","MTY",0,1,0)

このステートメントは、すべてのオカレンスを置換して、“MTY 030 MTY” を返します。

StringReplace("MTX 030 MTX","MTX","MTY",0,-1,0)

このステートメントは、大文字と小文字が一致するすべてのオカレンスを置換して、“MTY 030 mtx” を返します。

StringReplace("MTX 030 mtx","MTX","MTY",1,-1,0)

このステートメントは、完全に一致するすべてのオカレンスを置換して、“MTY 030 QMTX” を返します。

StringReplace("MTX 030 QMTX","MTX","MTY",0,-1,1)