値比較

値比較は、2 つのアトミック値を比較する処理です。 値比較の演算子には、eq、ne、lt、le、gt、および ge があります。

以下の表は、これらの演算子を説明しています。
表 1. XQuery における値比較演算子
演算子 用途
eq 1 番目の値が 2 番目の値と等しい場合に、true を戻します。
ne 1 番目の値が 2 番目の値と等しくない場合に、true を戻します。
lt 1 番目の値が 2 番目の値より小さい場合に、true を戻します。
le 1 番目の値が 2 番目の値より小さいか等しい場合に、true を戻します。
gt 1 番目の値が 2 番目の値より大きい場合に、true を戻します。
ge 1 番目の値が 2 番目の値より大きいか等しい場合に、true を戻します。
制約事項: 値比較のオペランドに FLWOR 式を含めることはできません。

2 つの値を比較できるのは、それらが同じタイプである場合、または一方のオペランドのタイプが他方のオペランドのタイプのサブタイプである場合です。 数値タイプ (xs:integer、xs:decimal、xs:double の各タイプ、およびこれらから派生したタイプ) の 2 つのオペランドは比較可能です。

特殊値: xs:double 値の場合、正のゼロと負のゼロは比較では等しいと見なされます。 INF は INF と等しく、-INF は -INF と等しくなります。 NaN は NaN 自身と等しくありません。 正の無限大は、他のすべての非 NaN 値より大きくなります。 負の無限大は、他のすべての非 NaN 値より小さくなります。 NaN ne NaN は true で、NaN 値を含むその他のすべての比較は false です。
値比較の結果は、ブール値、空シーケンス、またはエラーのいずれかです。 値比較の評価時には、各オペランドが原子化 (アトミック値に変換) され、以下の規則が適用されます。
  • 原子化されたオペランドのいずれかが空シーケンスである場合、値比較の結果は空シーケンスです。
  • 原子化されたオペランドのいずれかが複数の値を含むシーケンスである場合、エラーが戻されます。
  • 原子化されたオペランドのいずれかが型なしアトミック値 (xs:untypedAtomic) である場合、その値は xs:string にキャストされます。

    xs:untypedAtomic タイプの値を xs:string にキャストすると、値比較を推移的にすることができます。 これに対して、一般比較は型なしデータをキャストするために異なる規則に従うので、推移的にはなりません。

  • 評価後のオペランドのタイプが演算子にとって有効な組み合わせである場合、原子化されたオペランドに演算子が適用され、比較の結果は true または false のいずれかになります。 オペランドのタイプが比較演算子に有効な組み合わせでない場合、エラーが戻されます。

値比較演算子を使用して、以下のタイプを比較することができます。 「数値」という用語は、xs:integer、xs:decimal、xs:double の各タイプ、およびこのいずれかのタイプから派生したタイプを指します。 数値を含む比較では、サブタイプ置換および数値タイプのプロモーションを使用することにより、すべてのオペランドの変換先として可能な、順序付きリスト (xs:integer、xs:decimal、xs:double) 内の最初のタイプにオペランドが変換されます。

  • 数値
  • xs:boolean
  • xs:string
  • xs:date
  • xs:time
  • xs:dateTime
  • xs:yearMonthDuration
  • xs:dayTimeDuration
  • xs:duration (eq および ne のみ)

例

  • 以下の比較は、式 $book/author によって戻されるノードを原子化します。 この比較は、原子化の結果が、xs:string または xs:untypedAtomic のインスタンスとしての値「Kennedy」である場合にのみ true です。 原子化の結果が複数の値を含むシーケンスである場合、エラーが戻されます。
    $book1/author eq "Kennedy"
  • 以下のパス式には、重量が 100 より大きい製品を選択する述部が含まれています。 重量サブエレメントを持たない製品については、述部の値は空シーケンスになり、その製品は選択されません。
    //product[xs:decimal(weight) gt 100]
  • 以下の比較は true になります。 いずれの場合も、構成される 2 つのノードが異なる ID または名前を持っていても、原子化後に同じ値を持つためです。
    <a>5</a> eq <a>5</a> 
    <a>5</a> eq <b>5</b>