for 節

for 節は、式の結果を反復処理し、シーケンス内の各項目に変数をバインドします。

最も単純なタイプの for 節には、1 つの変数および関連する式が含まれます。 以下の例の for 節には、$i という変数と、シーケンス (1, 2, 3) を構成する式が含まれています。
SELECT XMLQUERY(
  'for $i in (1, 2, 3)
  return <output>{$i}</output>')
FROM SYSIBM.SYSDUMMY1
for 節の評価時には、以下の 3 つの変数バインディングが作成されます (シーケンス内の各項目に対して 1 つのバインディング)。
$i = 1
$i = 2
$i = 3
例の中の return 節は、各バインディングに対して 1 回実行されます。 この SQL ステートメントは、以下の行を持つ列を戻します。
<output>1</output><output>2</output><output>3</output>
for 節に複数の変数を含めることができ、それぞれが 1 つの式の結果にバインドされます。 以下の例の for 節には、2 つの変数 $a および $b と、シーケンス 1 2 および 4 5 を構成する式が含まれています。
SELECT XMLQUERY(
  'for $a in (1, 2), $b in (4, 5)
  return <output>{$a, $b}</output>'
  COLUMNS "x" XML PATH '.')
  FROM SYSIBM.SYSDUMMY1
for 節の評価時には、値の組み合わせごとに変数バインディングのタプルが作成されます。 結果として、変数バインディングの 4 つのタプルが作成されます。
($a = 1, $b = 4)
($a = 2, $b = 4)
($a = 1, $b = 5)
($a = 2, $b = 5)
例の中の return 節は、バインディングの各タプルに対して 1 回ずつ実行されます。 この SQL ステートメントは、以下の行からなる列を戻します。
<output>1 4</output>
<output>2 4</output>
<output>1 5</output>
<output>2 5</output>

バインディング式が空シーケンスとして評価される場合、for バインディングは生成されず、反復は実行されません。 以下の例のバインディング・シーケンスは空シーケンスとして評価されるため、反復は実行されません。 return 節のノード・シーケンスは戻されません。

SELECT XMLQUERY(
  'for $node in 
  (<a test="b" />,
   <a test="c" />,
   <a test="d" />)[@test = "1"] 
  return 
  <test>
    Sample return response
  </test>')
  FROM SYSIBM.SYSDUMMY1

for 節の中の定位置変数

for 節でバインドされるそれぞれの変数は、同時にバインドされる、関連する定位置変数を持つことができます。 定位置変数の名前の前には、キーワード at が付きます。 変数がシーケンス内の項目を反復処理するときに、定位置変数はシーケンス内のそれらの項目の位置を表す (1 で始まる) 整数を反復処理します。 他のすべての変数を参照するのと同じ方法で、定位置変数を参照することができます。

以下の例の for 節には、$cat という変数と、シーケンス ("Persian", "Calico", "Siamese") を構成する式が含まれています。 さらに、この節には定位置変数 $i が含まれ、属性コンストラクターの中でこれが参照されて order 属性の値が計算されます。
SELECT XMLQUERY(
  'for $cat at $i in 
  ("Persian", "Calico","Siamese")
  return <cat order="{$i}">{$cat}</cat>')
  FROM SYSIBM.SYSDUMMY1
for 節の評価時には、変数バインディングの 3 つのタプルが作成され、定位置変数のバインディングがそれぞれに含まれます。
($i = 1, $cat = "Persian")
($i = 2, $cat = "Calico")
($i = 3, $cat = "Siamese")
例の中の return 節は、バインディングの各タプルに対して 1 回ずつ実行されます。 この式の結果として、以下のような出力になります。
<cat order="1">Persian</cat><cat order="2">Calico</cat><cat order="3">Siamese</cat>
それぞれの出力エレメントには order 属性が含まれますが、(例えば order by $i のような) order by 節が FLWOR 式に含まれない限り、出力ストリーム内のエレメントの実際の順序は保証されません。 定位置変数は、出力シーケンスではなく、入力シーケンス内の値の順序位置を表します。