XQuery Funktionen


XQuery 1.0, XPath 2.0 und XSLT 2.0 verwenden dieselbe Funktionsbibliothek.


XQuery-Funktionen

XQuery enthält über 100 integrierte Funktionen. Diese Funktionen können für Zeichenkettenwerte, numerische Werte, Datums- und Zeitvergleiche, Knoten- und QName-Operationen, Sequenzoperationen, boolesche Werte usw. verwendet werden. Sie können auch eigene Funktionen in XQuery definieren.


Integrierte XQuery-Funktionen

Der URI des XQuery-Funktionsnamensraums:

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

Das Standardpräfix des Funktionsnamensraums ist fn:.

Tipp:Funktionen werden oft mit dem Präfix fn: aufgerufen, zum Beispiel fn:string(). Da fn: jedoch das Standardpräfix des Namensraums ist, muss der Funktionsname beim Aufruf nicht mit dem Präfix verwendet werden.

Sie finden das vollständigeReferenzhandbuch für integrierte XQuery-Funktionen》。


Beispiele für Funktionsaufrufe

Funktionsaufrufe können zusammen mit Ausdrücken verwendet werden. Siehe das folgende Beispiel:

Beispiel 1: In einem Element

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

Beispiel 2: Im Prädikat eines Pfadausdrucks

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

Beispiel 3: In einer let-Anweisung

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


Benutzerdefinierte Funktionen in XQuery

Wenn Sie die benötigte XQuery-Funktion nicht finden, können Sie Ihre eigene Funktion schreiben.

Benutzerdefinierte Funktionen können in einer Abfrage oder in einer eigenständigen Bibliothek definiert werden.

Syntax

declare function prefix:function-name($ParameterASDatentyp)
AS Rückgabedatentyp
{
 ...Funktionscode...
}

Hinweise zu benutzerdefinierten Funktionen:

  • Verwenden Sie das Schlüsselwort declare function
  • Der Funktionsname muss ein Präfix verwenden
  • Die Datentypen der Parameter stimmen normalerweise mit den in XML Schema definierten Datentypen überein.
  • Der Funktionskörper muss in geschweifte Klammern eingeschlossen werden.

Ein Beispiel für eine benutzerdefinierte Funktion, die in einer Abfrage deklariert wird:

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

Unten finden Sie ein Beispiel, wie die obige Funktion aufgerufen wird:

<minPrice>{local:minPrice($book/price,$book/discount)}</minPrice>
Andere Erweiterungen