home contribute faq download

FunctX XQuery Functions

functx:first-node

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

Google
Webxqueryfunctions.com

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.

Arguments and Return Type

NameTypeDescription
$nodes node()* the sequence of nodes
return value node()?

XQuery Function Declaration

See XSLT definition.
declare namespace functx = "http://www.functx.com";
declare function functx:first-node
  ( $nodes as node()* )  as node()? {

   ($nodes/.)[1]
 } ;

Examples

let $in-xml :=
<authors>
   <author>
      <fName>Kate</fName>
      <lName>Jones</lName>
   </author>
   <author>
      <fName>John</fName>
      <lName>Doe</lName>
   </author>
</authors>
return
XQuery ExampleResults
functx:first-node($in-xml//fName)
<fName>Kate</fName>
functx:first-node(
     ($in-xml//lName,
      $in-xml//fName) )
<fName>Kate</fName>

See Also

functx:precedes-not-ancestorWhether an XML node precedes another without being its ancestor
functx:last-nodeThe XML node in a sequence that is last in document order

History

Published OnLast UpdatedContributor(s)
2006-06-272007-02-26Priscilla Walmsley, Datypic, pwalmsley@datypic.com, http://www.datypic.com
Datypic XQuery Services

Recommended Reading:

XQuery