LOTUSSCRIPT 言語


ArrayReplace 関数
配列内の複数の値に対して、ルーチンの検索と置換を実行します。

構文ArrayReplace( sourceArray, compareArray, replaceArray )
構成要素sourceArray


compareArray
replaceArray
戻り値この規則で作成された配列 (戻り値の配列) を含む Variant 型です。
使用法sourceArray の各要素は、戻り値の配列にコピーできるようになっています。結果として得られる配列のサイズは、パラメータ sourceArray に含まれる配列のサイズと同じです。ソース配列および置き換えられる配列のデータ型が一致する場合は、戻り値の配列はその型になります。それ以外の場合は Variant 型の配列になります。
メモ ArrayReplace が機能するのは、LotusScript のスカラーデータ型である integer、long、single、double、currency、string、boolean、および byte を使った場合のみです。その他のデータ型を sourceArray replaceArray で使うと、結果として得られる配列には sourceArray とまったく同じデータ要素が含まれます。つまり、配列要素は何も置き換えられません。

sourceArray の各要素について、compareArray が検索されます。一致する要素がない場合は、戻り値の配列で次に使用可能なインデックスに sourceArray の要素がコピーされます。ただし、compareArray の要素が sourceArray の要素と一致する場合は、compareArray の要素のインデックスを使って replaceArray 配列の値が検索されます。次にこの値は sourceArray の値ではなく戻り値の配列にコピーされます。

次に例を示します。


compareArray からのインデックスが replaceArray へのインデックスとして使えない場合 (インデックスが範囲外の場合)、ゼロまたはそれに相当する型がその要素の戻り値の配列にコピーされます。

配列へのインデックスはそのベースから計算されます。compareArray が (-10 to 0) からの配列、replaceArray は (1 to 5) からの配列であるとします。compareArray の -10 番目の要素はその配列の 1 番目の要素であり、これが sourceArray の指定した要素と一致する場合、replaceArray 1 番目の要素が代替として使われます。

次に例を示します。


各要素型は、変換されたものと一致していなければなりません。たとえば、sourceArray に integer データ型の値 1 が含まれ、compareArray に long データ型の値 1 が含まれている場合、これらの要素は一致しません

拡張例:配列と文字列関数

関連項目