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" です。
