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 |