XQuery 関数


XQuery 1.0、XPath 2.0、XSLT 2.0 は同じ関数ライブラリを共有します。


XQuery 関数

XQuery には100以上の組み込み関数があります。これらの関数は、文字列値、数値、日付と時刻の比較、ノードとQNameの操作、シーケンス操作、論理値などに使用できます。XQuery で独自の関数を定義することもできます。


XQuery 組み込み関数

XQuery 関数名前空間の URI:

http://www.w3.org/2005/02/xpath-functions

関数名前空間のデフォルトプレフィックスは fn: です。

ヒント:関数はしばしば fn: プレフィックスを使用して呼び出されます(例: fn:string())。ただし、fn: は名前空間のデフォルトプレフィックスであるため、関数名を呼び出す際にプレフィックスを付ける必要はありません。

完全な《組み込み XQuery 関数リファレンスマニュアル》。


関数呼び出しの例

関数呼び出しは式と一緒に使用できます。次の例を見てください。

例1: 要素内での使用

<name>{upper-case($booktitle)}</name>

例2: パス式の述語内での使用

doc("books.xml")/bookstore/book[substring(title,1,5)='Harry']

例3: let 文内での使用

let $name := (substring($booktitle,1,4))


XQuery ユーザー定義関数

必要な XQuery 関数が見つからない場合は、独自の関数を書くことができます。

ユーザー定義関数は、クエリ内または独立したライブラリ内で定義できます。

構文

declare function プレフィックス:関数名($パラメータASデータ型)
AS 戻り値のデータ型
{
 ...関数コード...
}

ユーザー定義関数に関する注意事項:

  • declare function キーワードを使用してください
  • 関数名にはプレフィックスを使用する必要があります
  • パラメータのデータ型は、通常 XML Schema で定義されているデータ型と一致します
  • 関数本体は中括弧で囲む必要があります

クエリ内で宣言されたユーザー定義関数の例:

declare function local:minPrice($p as xs:decimal?,$d as xs:decimal?)
AS xs:decimal?
{
let $disc := ($p * $d) div 100
return ($p - $disc)
}

Below is an example of how to call the function above:

<minPrice>{local:minPrice($book/price,$book/discount)}</minPrice>
その他の拡張