local-name-from-QName (XQuery)

$arg により指定された QName のローカル部分を表す xs:NCNAME を返します。$arg が空のシーケンスの場合は、結果は空のシーケンスになります。

構文

fn:local-name-from-QName($arg as xs:QName?) as xs:NCName?

引数

  • $arg
    ローカル名部分を抽出する QName です。

このトピックでは、AdventureWorks データベースのさまざまな xml 型の列に格納されている XML インスタンスに対して実行する XQuery の例について説明します。これらの各列の概要については、「AdventureWorks データベースの xml データ型表現」を参照してください。

次の例は local-name-from-QName() 関数を使用して、QName 型の値から、ローカル名部分と名前空間 URI 部分を取得します。この例では、次の操作が実行されます。

  • XML スキーマ コレクションの作成。

  • xml 型の列を持つテーブルの作成。この xml 型は、XML スキーマ コレクションを使用して型指定されます。

  • サンプルの XML インスタンスのテーブルへの格納。xml データ型の query() メソッドを使用して、クエリ式を実行し、インスタンスから QName 型の値のローカル名部分を取得します。

DROP TABLE T
go
DROP XML SCHEMA COLLECTION SC
go
CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="QNameXSD" >
      <element name="root" type="QName" nillable="true"/>
</schema>'
go
 
CREATE TABLE T (xmlCol XML(SC))
go
-- following OK
insert into T values ('<root xmlns="QNameXSD" xmlns:a="http://someURI">a:someLocalName</root>')
 go
-- Retrieve the local name. 
SELECT xmlCol.query('declare default element namespace "QNameXSD"; local-name-from-QName(/root[1])')
FROM T
-- Result = someLocalName
-- You can retrive namespace URI part from the QName using the namespace-uri-from-QName() function
SELECT xmlCol.query('declare default element namespace "QNameXSD"; namespace-uri-from-QName(/root[1])')
FROM T
-- Result = http://someURI