fn:name 関数

fn:name 関数は、ノード名の接頭部とローカル名の部分を戻します。

構文

構文図を読む
>>-fn:name(-+------+-)-----------------------------------------><
            '-node-'     

ノード
名前を取得するノードの修飾名。 node が指定されていない場合、fn:name は現行コンテキスト・ノードについて評価されます。

戻り値

戻り値は xs:string 値です。値は、node の値によって異なります。
  • node が以下の条件に該当する場合、ゼロ長ストリングが戻されます。
    • node が空のシーケンスである。
    • node が、文書ノード、コメント、またはテキスト・ノードである。これらのノードは、名前を持っていません。
  • 以下の場合、エラーが戻されます。
    • コンテキスト・ノードが未定義である。
    • コンテキスト項目がノードでない。
    • node が複数のノードのシーケンスである。
  • それ以外の場合、node の接頭部 (存在する場合) とローカル名を含む xs:string 値が戻されます。

例

次の例は、ノード b の修飾名を戻します。
SELECT XMLSERIALIZE(
 XMLQUERY (  'declare namespace ns1="http://posample.org";
 fn:name($d/x/ns1:b)'
 PASSING XMLPARSE(DOCUMENT
 '<x xmlns:n="http://posample.org">
  <n:b><n:c></n:c></n:b></x>')
 AS "d")
 AS CLOB(1K) EXCLUDING XMLDECLARATION)
 FROM SYSIBM.SYSDUMMY1

戻り値は "n:b" です。

次の例は、引数を持たない fn:name() がコンテキスト・ノードを戻すことを示しています。

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

<customerinfo xmlns="http:⁄⁄posample.org" Cid="1001">
  <name>Kathy Smith<⁄name>
  <addr country="Canada">
    <street>25 EastCreek<⁄street>                        
    <city>Markham<⁄city>                                 
    <prov-state>Ontario<⁄prov-state>                     
    <pcode-zip>N9C 3T6<⁄pcode-zip>                       
  <⁄addr>                                                      
  <phone type="work">905-555-7258<⁄phone>               
<⁄customerinfo>

次の例は、コンテキスト・ノードの修飾名を戻します。

SELECT                                                            
XMLSERIALIZE(                                                     
XMLQUERY('declare default element namespace "http://posample.org";
 $X/customerinfo/phone/fn:name()'                                 
 PASSING INFO AS "X")                                             
 AS CLOB(1K))
 FROM CUSTOMER WHERE CID=1001                                                     

戻り値は "phone" です。