.. _functx_path-to-node:

===================
functx:path-to-node
=================== 

O caminho até um nó XML (ou uma sequência de nós)

Descrição
~~~~~~~~~
A função functx:path-to-node devolve o caminho até o nó, a partir do elemento 
raiz. Ela junta os nomes de todos os ancestrais, separados por barra.

Repare que não é necessariamente um caminho que devolve só aquele nó. Por 
exemplo, se authors tiver vários filhos author e você chamar a função para um 
author, ela devolve o caminho authors/author, que seleciona todos os autores, e 
não só aquele. Para um caminho único até o elemento, veja 
functx:path-to-node-with-pos.

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

   * - **Parâmetros**
     - **Descrição**
   * - nodes:node()
     - a sequência de nós

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

.. code-block:: xml

   <xsl:variable name="in-xml" as="item()*">
     <authors>
        <author>
           <fName>Kate</fName>
           <lName>Jones</lName>
        </author>
        <author>
           <fName>John</fName>
           <lName>Doe</lName>
        </author>
     </authors>
   
   </xsl:variable>

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

   * - **XPath**
     - **Resultado**
   * - functx:path-to-node($in-xml//lName[. = 'Doe'])
     - authors/author/lName
   * - functx:path-to-node($in-xml/\*[1])
     - authors/author

Veja também
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_path-to-node-with-pos`.
* :ref:`functx_distinct-element-paths`.