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

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

構文

@Compare( textlist ; textlist ; [ options ] )

パラメータ

textlist

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

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

[CASESENSITIVE] (デフォルト)

[CASEINSENSITIVE]

[ACCENTSENSITIVE] (デフォルト)

[ACCENTINSENSITIVE]

[PITCHSENSITIVE] (デフォルト)

[PITCHINSENSITIVE]

結果

数値リスト。各要素は文字列リストの対応する要素を比較した結果で、次の 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 ソートについて詳しくは、http://oss.software.ibm.com/icu/ を参照してください。

クロスリファレンス

LotusScript 言語の StrCompare 関数

例
関連項目

リストを処理する

用語集