.. _functx_is-node-among-descendants:

================================
functx:is-node-among-descendants
================================ 

Whether an XML node is among the descendants of a sequence, based on node 
identity

Description
~~~~~~~~~~~
The functx:is-node-among-descendants function returns a boolean value indicating 
whether or not a node is in the specified sequence, or among the descendants of 
nodes in a sequence, based on node identity. If $node or $seq is the empty 
sequence, it returns false.

Nodes are identified based on node identity, not their contents. For a similar 
function based on the contents of a node, see 
functx:is-node-among-descendants-deep-equal.

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

   * - **Parameters**
     - **Description**
   * - node:node()
     - the node to test
   * - seq:node()
     - the sequence of nodes to search

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

   * - **XPath**
     - **Results**
   * - functx:is-node-among-descendants($in-xml/price[1],$in-xml)
     - true
   * - functx:is-node-among-descendants($in-xml,$in-xml/price[1])
     - false
   * - functx:is-node-among-descendants($in-xml,$in-xml)
     - true
   * - functx:is-node-among-descendants($aPrice,$in-xml)
     - false

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_is-node-among-descendants-deep-equal`.
* :ref:`functx_is-node-in-sequence`.