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 戻り値のデータ型
{
...関数コード...
}
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>
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>