fn:compare 関数

fn:compare 関数は、2 つのストリングを比較します。

構文

>>-fn:compare(string-1,string-2)-------------------------------><

string-1 および string-2
比較される xs:string 値。Db2® は、各文字の数値 Unicode UTF-8 コード値を比較します。

戻り値

string-1 および string-2 が空のシーケンスでない場合、以下のいずれかの xs:integer 値が戻されます。
-1
string-1 が string-2 未満の場合。
0
string-1 が string-2 と等しい場合。
1
string-1 が string-2 より大きい場合。

2 つのストリングは、各ストリングの対応するバイトを比べることによって比較されます。 ストリングの長さが同じでない場合は、短い方のストリングがもう一方のストリングと同じ長さになるように、 右側をブランクで埋め込んだ一時コピーが作成され、それを使用して比較されます。

string-1 と string-2 は、 両方とも長さが 0 の場合、または対応するバイトがすべて同じ場合に等しいとみなされます。

string-1 と string-2 が等しくない場合、その関係 (より大きい値を持つ方) は、 ストリングの左端から比較して、等しくないバイトの最初の組の比較によって判別されます。この比較は、照合に従って行われます。

string-1 が string-2 より長く、string-2 のすべてのバイトが string-1 の 先行バイトと等しい場合、string-1 は string-2 よりも大きくなります。

string-1 または string-2 が空のシーケンスである場合、空のシーケンスが戻されます。

例

以下の関数は、デフォルトの照合を使用して 'ABC' と 'ABD' を比較します。

fn:compare('ABC', 'ABD')

'ABC' は 'ABD' よりも小さいです。戻り値は -1 です。