fn:last 関数

fn:last 関数は、現在処理中の項目のシーケンス内の値の数を戻します。

構文

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

戻り値

現在処理中のシーケンスが空のシーケンスでない場合、戻り値はシーケンス内の値の数を示す xs:integer 値です。現在処理中のシーケンスが空のシーケンスである場合、戻り値は空のシーケンスです。

以下の場合、エラーが戻されます。
  • fn:last が "/" または "//" によりそのコンテキスト項目から分離されている。
    例えば、以下の式はサポートされません。
    /a/b/c/fn:last
    /a/b/[c/fn:last=3]
  • コンテキスト・ノードが descendant 軸または descendant-or-self 軸を持っている。
    例えば、以下の式はサポートされません。
    /a/b/descendant::c[fn:last()=1]
  • コンテキスト・ノードがフィルター式であり、そのフィルター式が descendant 軸または descendant-or-self 軸を使用するステップを持っているか、またはネストされたフィルター式である。
    例えば、以下の式はサポートされません。
    /a/(b/descendant::c)[fn:last()=1]

例

サンプル CUSTOMER 表で、カスタマー 1003 の顧客文書は以下のようになります。

<customerinfo xmlns="http:⁄⁄posample.org" Cid="1003">
  <name>Robert Shoemaker<⁄name>
  <addr country="Canada">
    <street>1596 Baseline<⁄street>
    <city>Aurora<⁄city>
    <prov-state>Ontario<⁄prov-state>
    <pcode-zip>N8X-7F8<⁄pcode-zip>
  <⁄addr>
  <phone type="work">905-555-7258<⁄phone>
  <phone type="home">416-555-2937<⁄phone>
  <phone type="cell">905-555-8743<⁄phone>
  <phone type="cottage">613-555-3278<⁄phone>
<⁄customerinfo>

次の照会は、文書内の最後の電話番号を取得します。この照会は、fn:last 関数を使用して電話番号項目の数を判別し、その後 fn:last の結果を使用して最後の電話番号を指します。

SELECT                                                            
 XMLQUERY('declare default element namespace "http://posample.org";
 $X/customerinfo/phone[fn:last()]'                                
 PASSING INFO AS "X") FROM CUSTOMER WHERE CID=1003               

戻り値は、<phone type="cottage">613-555-3278<⁄phone> です。