関連項目

指定された文字列の一部を、別の文字列で指定された回数分置換した文字列を返します。

構文

Replace(expression, find, replacewith[, start[, count[, compare]]])

Replace 関数の構文は、次の指定項目から構成されます。

指定項目	内容
expression	必ず指定します。置換する文字列を含む文字列式を指定します。
find	必ず指定します。検索する文字列を指定します。
replacewith	必ず指定します。置換する文字列を指定します。
start	省略可能です。引数 expression 内の内部文字列の検索開始位置を指定します。引数 start を省略すると、1 を指定したものとみなされます。
count	省略可能です。置換する文字列数を指定します。引数 count を省略すると、既定値の -1 が使用され、すべての候補が置換されます。
compare	省略可能です。文字列式を評価するときに使用する文字列比較のモードを表す数値を指定します。設定する値については、次の「設定値」を参照してください。

設定値

引数 compare の設定値は次のとおりです。

定数	値	内容
vbBinaryCompare	0	バイナリ モードの比較を行います。
vbTextCompare	1	テキスト モードの比較を行います。
vbDatabaseCompare	2	比較を行うデータベースに格納されている方法に基づいて比較を行います。

戻り値

Replace 関数の戻り値は次のとおりです。

条件	Replace の戻り値
expression が長さ 0 の文字列 ("") のとき	長さ 0 の文字列 ("")
expression が Null 値のとき	エラー
find が長さ 0 の文字列 ("") のとき	expression のコピー
replacewith が長さ 0 の文字列 ("") のとき	find がすべて削除された expression のコピー
start の値が expression の文字数より大きいとき	長さ 0 の文字列 ("")
count が 0 のとき	expression のコピー

解説

引数 startを指定した場合、Replace 関数は、指定された位置から引数 expression の文字列の末尾までを返します。