Funciones XSLT y XPath

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

exactly-one

XPath

 

La función fn:exactly-one sólo devolverá la secuencia introducida en el argumento si consta de un único elemento. Si se cumple esta condición, la secuencia aparecerá invariable como valor de salida. De lo contrario se producirá un error. También se dará error si se introduce una secuencia sin contenido.

La función es de utilidad cuando sólo se necesita un valor y la transformación deba ser interrumpida si aparecen varios valores. Por ejemplo, en el caso de una consulta de nodos que esté dirigida a un solo nodo. Sin la función fn:exactly-one no se producirá necesariamente un error.

 

Argumentos

Secuencia

Obligatorio

Tipo: item()

 

Valor de salida

La secuencia de entrada, si ésta consta de un solo elemento.

Tipo: item()

 

 

Ejemplo

exactly-one(doc('ejemplos/ejemplo1.xml')/funciones/funcion[4]/nombre)

Resultado: fn:resolve-QName

 

 

Ejemplo

exactly-one(doc('ejemplos/ejemplo1.xml')/funciones/funcion[1]/nombre/apellido)

 

Resultado: Descripción: No se permite una secuencia vacía como primer argumento de exactly-one(); URL: www.w3.org/TR/2005/WD-xpath-functions-20050211/

La expresión XPath hace referencia a una secuencia de nodos vacía.

 

 

Ejemplo

exactly-one(())

 

Resultado: Descripción: No se permite una secuencia vacía como primer argumento de exactly-one(); URL: www.w3.org/TR/2005/WD-xpath-functions-20050211/

 

 

Ejemplo

exactly-one(doc('ejemplos/ejemplo1.xml')/funciones/funcion)

 

Resultado: Descripción: No se permite una secuencia con más de un elemento como primer argumento de exactly-one() (, , ...); URL: www.w3.org/TR/2005/WD-xpath-functions-20050211/

La expresión XPath hace referencia a una secuencia con varios elementos.

  > Volver a la referencia alfabética de XSLT y XPATH