.. _functx_is-ancestor:

==================
functx:is-ancestor
================== 

Se um nó XML é ancestral de outro nó

Descrição
~~~~~~~~~
A função functx:is-ancestor devolve um valor booleano que diz se $node1 é 
ancestral de $node2.

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

   * - **Parâmetros**
     - **Descrição**
   * - node1:node()
     - o primeiro nó
   * - node2:node()
     - o segundo nó

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:is-ancestor($in-xml//author[1], $in-xml//author[1]/fName)
     - true
   * - functx:is-ancestor($in-xml//author[1]/fName, $in-xml//author[1])
     - false
   * - functx:is-ancestor($in-xml//author[1]/fName, $in-xml//author[1]/fName/text())
     - true
   * - functx:is-ancestor($in-xml//author[1], $in-xml//author[2])
     - false

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_is-descendant`.