.. _functx_first-node:

=================
functx:first-node
================= 

The XML node in a sequence that appears first in document order

Description
~~~~~~~~~~~
The functx:first-node function returns the node in the sequence that appears 
first in document order. If nodes in the sequence are from multiple documents, 
which document is first is implementation-dependent.

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

   * - **Parameters**
     - **Description**
   * - nodes:node()
     - the sequence of nodes

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

   * - **XPath**
     - **Results**
   * - functx:first-node($in-xml//fName)
     - <fName>Kate</fName>
   * - functx:first-node(($in-xml//lName, $in-xml//fName) )
     - <fName>Kate</fName>

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_precedes-not-ancestor`.
* :ref:`functx_last-node`.