算術式

算術式では、加算、減算、乗算、除算、モジュラスなどの演算を実行します。

以下の表に、算術演算子とその説明を示し、演算子優先順位の高いものから順にリストします。 単項演算子の優先順位は、2 項演算子よりも高くなります。ただし、括弧を使用した場合は、2 項演算子の計算が先に行われます。
表 1. XQuery における算術演算子
演算子 目的 結合順序
-(単項)、+(単項) オペランドの値を否定する、オペランドの値を維持する 右から左
*、div、
idiv、mod
乗算、除算、整数除算、モジュラス 左から右
+, - 加算、減算 左から右
注: 減算演算子の前には空白文字が必要です。空白文字がないと、演算子が前のトークンの一部であると解釈されます。例えば、a-b は名前と解釈されますが、a - b や a -b は、算術演算と解釈されます。
制約事項: 算術演算子のオペランドに FLWOR 式を含めることはできません。

算術式の結果は、次のいずれかの項目です。

  • 数値
  • 日付値または時刻値
  • 期間値
  • 空シーケンス
  • エラー

XQuery は、以下のプロセスを使用して、算術式を評価します。

  1. 各オペランドをアトミック値のシーケンスにアトム化します。
  2. 以下の規則を使用して、算術式のオペランドを評価します。
    • アトム化されたオペランドが空のシーケンスである場合、 算術式の結果は空のシーケンスです。
    • アトム化されたオペランドが、値を複数含むシーケンスである 場合は、エラーが戻されます。
    • アトム化されたオペランドが型のないアトミック値 (xs:untypedAtomic) である場合、 XQuery は、その値を xs:double にキャストします。キャストが失敗した場合、XQuery は、エラーを戻します。
  3. オペランドのタイプがその算術演算子に有効な組み合わせである場合、 XQuery は、その演算子をアトム化された値に適用します。この演算の結果は、アトミック値または動的エラー (エラーは、例えば、 ゼロ除算によって発生します) になります。
  4. オペランドのタイプがその算術演算子に有効な組み合わせでない場合、 XQuery は、タイプ・エラーとみなします。
以下の表に、算術演算子に有効な組み合わせのタイプを示します。 この表では、文字 A は式の第 1 オペランドを、文字 B は第 2 オペランドを示します。数値という用語は、 タイプ xs:integer、xs:decimal、xs:double、またはこのいずれかのタイプから派生された任意のタイプを 示します。演算子の結果タイプが数値としてリストされている場合、結果タイプは、順序付けリスト (xs:integer、xs:decimal、xs:double) のタイプのうち、サブタイプ置換およびタイプ・プロモーションによってすべてのオペランドをそのタイプに変換できる、最初のタイプになります。
表 2. 算術式のオペランドに有効なタイプ
演算子とオペランド オペランド A タイプ オペランド B タイプ 結果タイプ
A + B 数値 数値 数値
xs:date xs:yearMonthDuration xs:date
xs:yearMonthDuration xs:date xs:date
xs:date xs:dayTimeDuration xs:date
xs:dayTimeDuration xs:date xs:date
xs:time xs:dayTimeDuration xs:time
xs:dayTimeDuration xs:time xs:time
xs:dateTime xs:yearMonthDuration xs:dateTime
xs:yearMonthDuration xs:dateTime xs:dateTime
xs:dateTime xs:dayTimeDuration xs:dateTime
xs:dayTimeDuration xs:dateTime xs:dateTime
xs:yearMonthDuration xs:yearMonthDuration xs:yearMonthDuration
xs:dayTimeDuration xs:dayTimeDuration xs:dayTimeDuration
A - B 数値 数値 数値
xs:date xs:date xs:dayTimeDuration
xs:date xs:yearMonthDuration xs:date
xs:date xs:dayTimeDuration xs:date
xs:time xs:time xs:dayTimeDuration
xs:time xs:dayTimeDuration xs:time
xs:dateTime xs:dateTime xs:dayTimeDuration
xs:dateTime xs:yearMonthDuration xs:dateTime
xs:dateTime xs:dayTimeDuration xs:dateTime
xs:yearMonthDuration xs:yearMonthDuration xs:yearMonthDuration
xs:dayTimeDuration xs:dayTimeDuration xs:dayTimeDuration
A * B 数値 数値 数値
xs:yearMonthDuration 数値 xs:yearMonthDuration
数値 xs:yearMonthDuration xs:yearMonthDuration
xs:dayTimeDuration 数値 xs:dayTimeDuration
数値 xs:dayTimeDuration xs:dayTimeDuration
A idiv B 数値 数値 xs:integer
A div B 数値 数値 数値 (両方のオペランドが xs:integer の場合は xs:decimal)
xs:yearMonthDuration 数値 xs:yearMonthDuration
xs:dayTimeDuration 数値 xs:dayTimeDuration
xs:yearMonthDuration xs:yearMonthDuration xs:decimal
xs:dayTimeDuration xs:dayTimeDuration xs:decimal
A mod B 数値 数値 数値

構文

構文図を読む
arithmetic expression

>>-Multiplicative-expression--+------------------------------+-><
                              +-+--Multiplicative-expression-+   
                              '-?--Multiplicative-expression-'   

multiplicative expression

   .------------------------.                                             
   V                        |                                             
>>---+---+--path_expression-+--+--------------------------------------+-><
     +-+-+                     |           .------------------------. |   
     '-?-'                     |           V                        | |   
                               '-+-*----+----+---+--path_expression-+-'   
                                 +-div--+    +-+-+                        
                                 +-idiv-+    '-?-'                        
                                 '-mod--'                                 

例

以下の照会は、算術式を使用して、購入者が支払う税金の額 (8.25% の税率で製品にかかる) を計算し、税金が 1 通貨単位を超える記述エレメントを選択します。

SELECT XMLQUERY ('declare namespace pos="http://posample.org";
  /pos:product/description[price * .0825 > 1]'
  PASSING DESCRIPTION)
FROM T1
以下の照会は、2 つの xs:date 値を減算します。その結果は xs:yearMonthDuration 値 P8559D になります。
SELECT XMLQUERY(' xs:date("2005-10-10")
  - xs:date("1982-05-05")')
 FROM SYSIBM.SYSDUMMY1