XQuery Funciones


XQuery 1.0, XPath 2.0 y XSLT 2.0 comparten la misma biblioteca de funciones.


XQuery Funciones

XQuery contiene más de 100 funciones incorporadas. Estas funciones se pueden utilizar para valores de cadena, numéricos, comparaciones de fechas y horas, operaciones con nodos y QName, operaciones con secuencias, valores booleanos, etc. También puede definir sus propias funciones en XQuery.


XQuery Funciones incorporadas

El URI del espacio de nombres de las funciones XQuery:

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

El prefijo predeterminado del espacio de nombres de funciones es fn:.

Consejo:Las funciones a menudo se invocan mediante el prefijo fn:, por ejemplo fn:string(). Sin embargo, dado que fn: es el prefijo predeterminado del espacio de nombres, los nombres de funciones no necesitan usar el prefijo al ser invocados.

Puede encontrar el «Manual de referencia de funciones XQuery incorporadas》。


Ejemplos de llamadas a funciones

Las llamadas a funciones se pueden usar junto con expresiones. Vea el siguiente ejemplo:

Ejemplo 1: En un elemento

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

Ejemplo 2: En el predicado de una expresión de ruta

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

Ejemplo 3: En una declaración let

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


XQuery Funciones definidas por el usuario

Si no encuentra la función XQuery deseada, puede escribir su propia función.

Las funciones definidas por el usuario se pueden definir en una consulta o en una biblioteca independiente.

Sintaxis

declare function prefijo:nombre_función($ParámetrosASTipo de datos)
AS Tipo de datos devuelto
{
 ...Código de la función...
}

Notas sobre las funciones definidas por el usuario:

  • Use la palabra clave declare function
  • El nombre de la función debe usar un prefijo
  • Los tipos de datos de los parámetros suelen ser los mismos que los definidos en XML Schema.
  • El cuerpo de la función debe estar encerrado entre llaves.

Un ejemplo de una función definida por el usuario declarada en una consulta:

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>
Otras extensiones