条件式

条件式では、キーワード if、then、および else を使用して、テスト式の値が true または false のいずれであるかに応じて 2 つの式のいずれかを評価します。

構文

構文図を読む
>>-if--(--test-expression--)--then--expression1--else--expression2-><

if
テスト式の直前に配置するキーワード。
test-expression
条件式のどの部分を評価するかを決定する XQuery 式。
then
test-expression の有効なブール値が true である場合、このキーワードの後の式が評価されます。 テスト式の有効なブール値が false である場合、式は評価またはエラー・チェックされません。
else
test-expression の有効なブール値が false である場合、このキーワードの後の式が評価されます。 テスト式の有効なブール値が true である場合、式は評価またはエラー・チェックされません。
expression1 および expression2
任意の XQuery 式。 式に最上位のコンマ演算子が含まれる場合、式を括弧で囲む必要があります。
条件分岐 then または else のいずれかに更新式が含まれる場合、条件式は更新式となります。 更新式は、変換式の modify 節の中に含まれる必要があります。
更新条件式のそれぞれの分岐には、1 つの更新式または空シーケンスのいずれかが含まれる必要があります。 テスト式の値に基づいて、then 節または else 節のいずれかが選択され、評価されます。 条件更新式の結果は、選択された分岐によって戻された更新からなるリストになります。 それを含んでいる変換式は、それらの更新を変換式の modify 節内の他の更新式によって戻される更新とマージした後で、それらを実行します。
制約事項: test-expression、expression1、expression2 には FLWOR 式を含めることができません。

例

PURCHASEORDER 表の列 PORDER に、以下のデータが含まれているとします。

<ipo:purchaseOrder
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:ipo="http://www.example.com/IPO"
   orderDate="2008-12-01">
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Helen Zoe</name>
    <street>55 Eden Street</street>
    <city>San Jose</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Joe Lee</name>
    <street>66 University Avenue</street>
    <city>Palo Alto</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <billTo xsi:type="ipo:USAddress">
    <name>Robert Smith</name>
    <street>8 Oak Avenue</street>
    <city>Old Town</city>
    <state>PA</state>
    <zip>95819</zip>
  </billTo>
  <items>
    <item partNum="833-AA">
      <productName>Lapis necklace</productName>
      <quantity>1</quantity>
      <USPrice>99.95</USPrice>
      <ipo:comment>Want this for the holidays!</ipo:comment>
      <shipDate>2008-12-05</shipDate>
    </item>
    <item partNum="945-ZG">
      <productName>Sapphire Bracelet</productName>
      <quantity>2</quantity>
      <USPrice>178.99</USPrice>
      <shipDate>2009-01-03</shipDate>
    </item>
  </items>
</ipo:purchaseOrder>
以下の例では、item エレメントのリストが照会によって構成されます。 item (品目) の shipping エレメントの値は、USPrice エレメントの値が 100 より小さいという条件に当てはまるかどうかに基づいて指定されます。 この例のテスト式は、USPrice エレメントの値から xs:decimal 値を構成します。 強制的に 10 進数比較を行うために、xs:decimal 関数が使用されます。
SELECT XMLQUERY(
  'declare namespace ipo="http://www.example.com/IPO";
  for $i in $po/ipo:purchaseOrder/items/item
  return
  <item>
   {$i/productName}
   <shipping>
     { if (xs:decimal($i/USPrice) lt 100) then 5 else 10 }
   </shipping>
  </item>'
  PASSING PORDER as "po") 
  FROM PURCHASEORDER
この照会は以下の結果を戻します。
<item>
  <productName
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ipo="http://www.example.com/IPO">
    Lapis necklace
  </productName>
  <shipping>5</shipping>
</item>
<item>
  <productName
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ipo="http://www.example.com/IPO">
    Sapphire Bracelet
  </productName>
  <shipping>10</shipping>
</item>