.. _functx_distinct-element-paths:

=============================
functx:distinct-element-paths
============================= 

The distinct paths of all descendant elements in an XML fragment

Description
~~~~~~~~~~~
The functx:distinct-element-paths function returns a sequence of strings 
representing the paths of elements that are in $nodes or among their 
descendants.

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

   * - **Parameters**
     - **Description**
   * - nodes:node()
     - the root(s) to start from

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

   * - **XPath**
     - **Results**
   * - functx:distinct-element-paths($in-xml)
     - ('authors', 'authors/author', 'authors/author/fName', 'authors/author/lName')
   * - functx:distinct-element-paths($in-xml/author[1])
     - ('authors/author', 'authors/author/fName', 'authors/author/lName')

Depends On
~~~~~~~~~~
* :ref:`functx_path-to-node`.

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_distinct-element-names`.
* :ref:`functx_path-to-node`.
* :ref:`functx_dynamic-path`.