fn:position 関数

fn:position 関数は、現在処理中のシーケンスにおけるコンテキスト項目の位置を戻します。

position 関数は、通常は述部で使用されます。ただし、それを使用して、そのコンテキスト項目の各オカレンスの位置を生成することもできます。

構文

構文図を読む
>>-fn:position()-----------------------------------------------><

戻り値

戻り値は、現在処理中のシーケンスにおけるコンテキスト項目の位置を示す xs:integer 値です。シーケンス内の最初の項目の位置は 1 です。コンテキスト項目が未定義の場合は、エラーが戻されます。position 関数は、コンテキスト項目を含むシーケンスの順序が決まっている場合にのみ、決まった結果を戻します。

例

次の照会は、文書 <x xmlns="http://posample.org"><b><c>x</c><c>y</c><c>z</c></b></x>内の <c> エレメントのシーケンスの 2 番目のエレメントを戻します。

SELECT XMLSERIALIZE(
 XMLQUERY ('declare default element namespace "http://posample.org"; 
 $d/x/b/c[fn:position()=2]'
 PASSING XMLPARSE(DOCUMENT
 '<x xmlns="http://posample.org">
 <b><c>x</c><c>y</c><c>z</c></b></x>')
 AS "d")
 AS CLOB(1K) EXCLUDING XMLDECLARATION)
 FROM SYSIBM.SYSDUMMY1

戻り値は "y" です。

次の照会は、<a><b><c> の各オカレンスの位置を戻します。

SELECT XMLSERIALIZE(                                   
XMLQUERY('/a/b/c/fn:position()'                        
   PASSING XMLPARSE(DOCUMENT                           
   '<a><b><c>c1</c></b><b><c>c2</c><c>c3</c></b></a>'))
   AS CLOB(1K))                                        
   FROM SYSIBM.SYSDUMMY1                              

戻り値は "1 2 3" です。