Lotus Domino Designer 7 ヘルプ

式言語

@Compare
例

2 つのリストの要素のアルファベット順を、並列演算によって比較します。

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

構文
@Compare( textlist ; textlist ; [ options ] )

パラメータ
textlist

文字列リスト。最初の 2 つのパラメータは文字列リストです。一方のリストが短いとき、長い方のリストと同じ長さになるまで、短い方のリストの最後の要素が繰り返されます。各リストの対応する要素が比較されます。

[ options ]

キーワードリスト。以下のキーワードを指定できます。指定したオプションが競合する場合は、最後に指定したオプションが有効になります。

[CASESENSITIVE] (デフォルト)

[CASEINSENSITIVE]

[ACCENTSENSITIVE] (デフォルト)

[ACCENTINSENSITIVE]

[PITCHSENSITIVE] (デフォルト)

[PITCHINSENSITIVE]

戻り値
result

数値リスト。各要素は文字列リストの対応する要素を比較した結果で、次の 3 つのいずれかの値となります。

2 つの文字列リストの要素が等しいときは 0 です。
最初のリストの要素が 2 つ目のリストの要素よりも小さいときは -1 です。たとえば、最初のリストの要素が alice で、2 つ目のリストの要素が bobby のときはこの結果が返されます。
最初のリストの要素が 2 つ目のリストの要素よりも大きいときは 1 です。たとえば、最初のリストの要素が bobby で、2 つ目のリストの要素が alice のときはこの結果が返されます。

使い方
英語文字セットの比較順序は次の通りです。アポストロフィ、ダッシュ、0 から 9 までの数字、a から z および A から Z までの英字、残りの特殊文字の順です。英字の比較順序は、小文字が先で、a、A、b、B、というように z、Z まで続きます。このような順で比較されるので、たとえば「New Boston」より「new york」が先であるという変則的な結果が生じることがあります。このような動作の問題を解消するには、[CaseInsensitive] オプションを使うか、@UpperCase、@LowerCase、@ProperCase を使います。

ソートオプションとして Unicode スタンダードソートを設定しているときは、次のキーワードや組み合わせは選択できません。

[PITCHINSENSITIVE]
[CASESENSITIVE]:[ACCENTINSENSITIVE]

Unicode スタンダードソートを指定するには、notes.ini の変数 $CollationType を @UCA に設定するか、以下のダイアログボックスの [Unicode スタンダードソート] チェックボックスをオンにします。

[ソート] ダイアログボックス (メインメニューから [ファイル] - [プリファレンス] - [ユーザー] - [インターナショナル] - [ソート] を選択して表示)
[データベースのプロパティ] インフォボックス*
[設計のプロパティ] インフォボックス*

*デフォルトのソート順序が選択されていない場合は、[データベースのプロパティ] インフォボックスと [設計のプロパティ] インフォボックスの Unicode オプションは無効化されます。

Unicode ソートについて詳しくは、http://oss.software.ibm.com/icu/ を参照してください。

クロスリファレンス
LotusScript 言語の StrCompare 関数

用語集

用語集