指定されたサブ文字列を別のサブ文字列に指定回数だけ置き換えた String を返します。
構文
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 Office Access 2007 のみ。 データベース内の情報に基づいて比較を実行します。 |
戻り値
Replace は次の値を返します。
| 状況 | Replace が返す値 |
|---|---|
| expression は長さが 0 です | 長さゼロの文字列 ("") |
| expression は Null です | エラー。 |
| find は長さが 0 です | 式のコピー。 |
| replace は長さが 0 です | 検索のすべての出現が削除された式のコピー。 |
| start>Len(expression) | 長さ 0 の文字列。 文字列の置換は、start で示される位置から 始まります。 |
| count は 0 です | 式のコピー。 |
解説
Replace 関数の戻り値は、置換が行われた文字列で、start で指定された位置から始まり、式文字列の末尾で終了します。 開始から終了までの元の文字列のコピーではありません。
使用例
| Expression | 結果 |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplacedID FROM ProductSales; | "ProductID" を返し、"ProductID" で "PRO" を検索し、"Product" に置き換えて、結果を列 ReplacedID に表示します。 |