.. _trace:

=====
trace
===== 

Registra informações de rastreio de um jeito definido pela implementação

Descrição
~~~~~~~~~
A função fn:trace recebe itens e um rótulo para eles, e devolve os itens sem 
mudança. O comportamento exato depende da implementação, mas em geral o 
processador grava o rótulo e o valor dos itens num arquivo de log ou no console.

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - **Parâmetros**
     - **Descrição**
   * - value:item()
     - os itens a rastrear
   * - label:string()
     - um rótulo mostrado junto com o rastreio

Exemplos
~~~~~~~~
Os exemplos abaixo usam este documento de entrada:

.. code-block:: xml

   <xsl:variable name="var1" select="4"/>

.. list-table::
   :widths: 25 25 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - trace($var1, 'The value of $var1 is: ')
     - 4
     - Devolve $var1 sem mudança; a mensagem 'The value of $var1 is: 4' vai para o log.