Replace 関数

開始位置から始まる文字列式の部分文字列である文字列 (既定値は 1) を返します。この文字列では、指定した部分文字列が指定した回数別の部分文字列に置き換えられます。

構文

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

Replace 関数の構文には、次の名前付き引数があります。

パーツ	説明
expression	必須。置換処理を行うサブ文字列が格納されている文字列式。
find	必須。検索するサブ文字列。
replace	必須。置換後の文字列。
start	省略可能。検索して返される式の部分文字列の開始位置。省略した場合は、1 が使用されます。
count	省略可能。実行するサブ文字列置換の回数。省略すると、既定値は -1 になります。つまり、可能なすべての置換を行います。
compare	省略可能。サブ文字列を評価するときに使用する比較の種類を示す数値です。値については、「設定」セクションを参照してください。

compare 引数には、次の値を指定できます。

定数	値	説明
vbUseCompareOption	-1	Option Compare ステートメントの設定を使用して比較を実行します。
vbBinaryCompare	0	バイナリ比較を実行します。
vbTextCompare	1	テキスト比較を実行します。
vbDatabaseCompare	2	Microsoft Access のみ。データベース内の情報に基づいて比較を実行します。

Replace では次の値が返されます。

条件	Replace の戻り値
expression の長さがゼロである	長さがゼロの文字列 ("")。
expression が Null である	エラー。
find の長さがゼロである	式のコピー。
replace の長さがゼロである	検索のすべての出現箇所が削除された式のコピー。
開始>Len(expression)	長さがゼロの文字列。文字列の置換は、start で示される位置から始まります。
count が 0 である	式のコピー。

Replace 関数の戻り値は、置換が行われた文字列で、start で指定された位置から始まり、式文字列の末尾で終了します。最初から最後まで元の文字列のコピーではありません。