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

trace

XPath

 

La función fn:trace admite una secuencia de entrada en el primer argumento y un comentario en el segundo. Normalmente esta función no tiene ninguna repercusión sobre la secuencia de entrada, que se devuelve sin cambios. Sin embargo esta función puede ser útil para tareas de depuración o búsqueda de errores, ya que en el archivo de registro se asignará el comentario a la secuencia de entrada.

Debido a que esta función no tiene ninguna incidencia sobre los valores, puede preceder a otras funciones. De esta manera es posible en una búsqueda de errores introducir comentarios en las otras funciones. Por ejemplo: función de ejemplo (trace($valor, 'este es el $valor de la función-ejemplo')). La manera en que se realice la documentación en el archivo de registro dependerá de la aplicación que se esté usando.

 

Argumentos

Secuencia de entrada

Es obligatorio, pero puede ser una secuencia vacía.

Tipo: item()

 

Comentario a asignar a la secuencia de entrada

Obligatorio. Puede ser una cadena vacía, pero no una secuencia vacía.

Tipo: xs:string

 

Valor de salida

Secuencia de entrada sin cambios. En el archivo de registro aparecerá comentada.

Tipo: item()

 

 

Ejemplo

trace((2,3,4,5), 'Diese bestimmte Sequenz enthält:')

Resultado: 2 3 4 5

Se devolverá la secuencia de entrada (2,3,4,5) sin cambios. En el archivo de registro se añadirá la cadena (el modo dependerá de la aplicación) a la secuencia introducida en el segundo argumento a modo de comentario.

 

 

Ejemplo

trace(one-or-more(doc('ejemplos/ejemplo1.xml')/funciones/funcion/nombre), 'Esta secuencia no puede estar vacía:')

Resultado: fn:QName fn:sum fn:max fn:resolve-QName

Si se produce un error, se comentarán los contenidos de esta expresión XPath en el archivo de registro con la cadena 'Esta secuencia no puede estar vacía:'. En el caso de que se introduzca una secuencia vacía, será fácil identificar el motivo del error.

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