文字列内の特定の単語や語句を、指定する単語や語句に置換します。

メモ この関数は Lotus Domino Release 6 で新しく追加されました。

構文

Replace(sourceArray, findArray, replacementArray [, start [, count [, compMethod]]])

要素

sourceArray

変更する文字列を含む String 型の配列です。

置き換えの対象になる文字列を含む String 型の配列です。

置き換える別の文字列を含んだ String 型の配列です。

省略可能。各文字列の文字の開始位置を示す数値です。

省略可能。置換の最大回数を示す数値です。

省略可能。要素が String 型の場合、区切り記号を検索するときに使用する、比較のタイプを指定する Integer 型です。

数値	比較のモード
0	大文字と小文字および全角と半角を区別します。
1	大文字と小文字を区別しません。全角と半角を区別します。
4	大文字と小文字を区別します。全角と半角を区別しません。
5	大文字と小文字を区別しません。全角と半角を区別しません。


compMethod を省略すると、既定の比較モードはこのモジュールの Option Compare ステートメントで設定されたモードになります。モジュールに何もステートメントがなければ、大文字と小文字および全角と半角が区別される比較方法が既定となります。

sourceArray を含む String 型の配列を返します。配列では replaceArray の値が replacementArray の対応する値で置き換えられています。

使用法

Replace は sourceArray の文字列から replaceArray の文字列を検索します。一致する値が見つかると、部分文字列は replacementArray の対応する部分文字列に置換されます。前の置換で修正されるたびに replaceArray の各文字列は sourceArray の各文字列に対して調べられます。置換では大文字と小文字が区別されます。

一致する要素がない場合は sourceArray のコピーが返されます。

replacementArray よりも多くの文字列が replaceArray で指定されると、replaceArray の余分な文字列は replacementArray の最後の文字列で置換されます。replacementArray の余分な文字列は無視されます。

以下に例を示します。

sourceArray = ["first second third"]

replaceArray = ["first"]["second"]["1"]["third"]["2"]["3"]

replacementArray = ["1"]["2"]["a"]["3"]["b"]["c"]

最初に Replace は、「first」を「1」で置換します (replacementArray の最初の文字列で replaceArray の最初の文字列が置換されます)。

["1 second third"]

["1 2 third"]

["a 2 third"]

["a 2 3"]

["a b 3"]

["a b c"]

クロスリファレンス

式言語の @Replace 関数

式言語の EditFind @コマンド

例
関連項目

LotusScript ランゲージリファレンス: Q - T
Mid ステートメント

用語集