XQuery における関数呼び出し

XQuery は、組み込み XQuery 関数の呼び出しをサポートします。

組み込み XQuery 関数は、ネーム・スペース http://www.w3.org/2003/11/xpath-functions にあります。 関数呼び出し内の関数名にネーム・スペース接頭部がない場合、関数は、 デフォルトの関数ネーム・スペース内にあるとみなされます。

XQuery は、以下のプロセスで関数を評価します。

  1. XQuery は、関数呼び出しで引数として渡される各式を評価し、各式の値を戻します。
  2. 各引数について戻される値が、その引数に 期待されるデータ・タイプに変換されます。期待されるタイプがゼロ以上のアトミック・タイプのシーケンスである場合、XQuery は、以下の規則を使用して、値をその期待されるタイプに変換します。
    1. 指定した値が、アトミック値のシーケンスにアトム化されます。
    2. アトミック・シーケンス内の xs:untypedAtomic タイプの各項目は、 期待されるアトミック・タイプにキャストされます。期待されるタイプとして numeric が 指定された組み込み関数の場合、xs:untypedAtomic タイプの引数は xs:double にキャストされます。
    3. 数値タイプのプロモーションにおいて期待されるアトミック・タイプにプロモート可能な、 アトミック・シーケンス内のすべての数値項目に、数値タイプ・プロモーションが適用されます。数値項目は、xs:integer、xs:decimal、または xs:double タイプの 項目です。
  3. 関数は、その引数の変換済みの値を使用して評価されます。 関数呼び出しの結果は、関数の宣言済みの戻り値のタイプのインスタンスまたは エラーのいずれかです。

例

以下の関数呼び出しは、product 文書の PID 属性の最初の 3 文字を取り出します。
SELECT XMLQUERY ('declare namespace pos="http://posample.org";
  fn:substring(/pos:product/@pid, 1, 3)'
  PASSING DESCRIPTION)
FROM T1;