.. _root:

====
root
==== 

A raiz da árvore que contém o argumento

Descrição
~~~~~~~~~
A função fn:root devolve um nó de documento se o nó $arg fizer parte de um 
documento, mas também pode devolver um elemento se o nó $arg não fizer parte de 
um documento.

Chamar fn:root é parecido com começar um caminho com /. É mais flexível, porque 
pode aparecer em qualquer ponto de um caminho ou de outra expressão. E, ao 
contrário de começar com /, fn:root não exige que a raiz seja um nó de 
documento: pode ser um elemento, no caso de um fragmento de documento.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:node()
     - o nó cuja raiz se quer achar

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

.. code-block:: xml

   <xsl:variable name="in-xml" as="item()*">
     <a><x>123</x></a>
   </xsl:variable>

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

   * - **XPath**
     - **Resultado**
   * - root(doc('http://www.functx.com/input/order.xml')//item[1])
     - The document node of order.xml
   * - root($in-xml/x)
     - <a><x>123</x></a>