XQuery Fonctions


XQuery 1.0, XPath 2.0 et XSLT 2.0 partagent la même bibliothèque de fonctions.


Fonctions XQuery

XQuery contient plus de 100 fonctions intégrées. Ces fonctions peuvent être utilisées pour les valeurs de chaîne, les valeurs numériques, la comparaison de dates et d'heures, les opérations sur les nœuds et les QName, les opérations sur les séquences, les valeurs booléennes, etc. Vous pouvez également définir vos propres fonctions dans XQuery.


Fonctions intégrées de XQuery

L'URI de l'espace de noms des fonctions XQuery :

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

Le préfixe par défaut de l'espace de noms des fonctions est fn:.

Astuce :Les fonctions sont souvent appelées avec le préfixe fn:, par exemple fn:string(). Toutefois, comme fn: est le préfixe par défaut de l'espace de noms, le nom de la fonction n'a pas besoin d'utiliser le préfixe lorsqu'elle est appelée.

Vous pouvez trouver le manuel de référence completdes fonctions intégrées XQuery》。


Exemples d'appels de fonctions

Les appels de fonctions peuvent être utilisés avec des expressions. Voir l'exemple ci-dessous :

Exemple 1 : Dans un élément

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

Exemple 2 : Dans le prédicat d'une expression de chemin

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

Exemple 3 : Dans une instruction let

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


Fonctions définies par l'utilisateur en XQuery

Si vous ne trouvez pas la fonction XQuery dont vous avez besoin, vous pouvez écrire votre propre fonction.

Les fonctions définies par l'utilisateur peuvent être définies dans une requête ou dans une bibliothèque autonome.

Syntaxe

declare function prefix:function-name($ParamètresASType de données)
AS Type de données de retour
{
 ...Code de la fonction...
}

Remarques sur les fonctions définies par l'utilisateur :

  • Utilisez le mot-clé declare function
  • Le nom de la fonction doit utiliser un préfixe
  • Les types de données des paramètres correspondent généralement aux types de données définis dans XML Schema.
  • Le corps de la fonction doit être entouré d'accolades.

Un exemple de fonction définie par l'utilisateur déclarée dans une requête :

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

Voici un exemple d'appel de la fonction ci-dessus :

<minPrice>{local:minPrice($book/price,$book/discount)}</minPrice>
Autres extensions