LOTUSSCRIPT 言語


Replace 関数

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

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

構文Replace(sourceArray, findArray, replacementArray [, start [, count [, compMethod]]])
構成要素sourceArray


findArray
replacementArray
start
count
compMethod
戻り値sourceArray を含む String 型の配列を返します。配列では replaceArray の値が replacementArray の対応する値で置き換えられています。
使用法Replace は sourceArray の文字列から replaceArray の文字列を検索します。一致する値が見つかると、部分文字列は replacementArray の対応する部分文字列に置換されます。前の置換で修正されるたびに replaceArray の各文字列は sourceArray の各文字列に対して調べられます。置換では大文字と小文字が区別されます。
一致する要素がない場合は sourceArray のコピーが返されます。

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

次に例を示します。


戻り値: ["a b c"]

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


次に Replace は、「second」を「2」で置換します。
さらに、"1" を "a" で置換します (最初の置換で「first」が「1」に置換されたため)。
「third」を「3」で置換します。
「2」を「b」で置換します。
最後に、「3」を「c」で置換します。
sourceArray、replaceArray、または replacementArray が文字列でない場合、あるいは String 型の配列でない場合は、型の不一致ランタイムエラーが発生します。

クロスリファレンス式言語の @Replace 関数
式言語の EditFind @コマンド


関連項目