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

zero-or-one

XPath

 

La función fn:zero-or-one sólo devolverá la cadena introducida en el argumento si ésta contiene un elemento o ninguno. Si se cumple esta condición la secuencia se devolverá sin cambios. En caso contrario de producirá un error.

La función es útil cuando es necesaria una secuencia vacía o compuesta de un solo elemento y el procesamiento deba ser interrumpido si esta condición no se cumple. Por ejemplo, en una consulta de nodos que busque como máximo un nodo. Sin esta función no se producirá necesariamente un error.

 

Argumentos

Secuencia

Obligatorio

Tipo: item()

 

Valor de salida

La misma secuencia de entrada si esta posee un nodo o ninguno

Tipo: item()

 

 

Ejemplo

zero-or-one(doc('ejemplos/ejemplo1.xml')/root/function[4]/name)

Resultado: fn:resolve-QName

 

 

Ejemplo

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

Resultado:

 

 

Ejemplo

zero-or-one(())

Resultado:

 

 

Ejemplo

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

 

Resultado: Aviso de error: A sequence of more than one item is not allowed as the first argument of zero-or-one() (, , ...) URL: www.w3.org/TR/2005/WD-xpath-functions-20050211/

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