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.
XQuery Syntax for July 2004 - January 2007 (1.0):
declare namespace functx = "http://www.functx.com"; 
declare function functx:first-node 
  ( $nodes as node()* )  as node()? {
       
   ($nodes/.)[1]
 } ;
XQuery Syntax for May 2003:
declare namespace functx = "http://www.functx.com" 
define function 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
Need XQuery Help?
D A T Y P I C
Training | Consulting | Development

XQuery by Priscilla WalmsleyGet the book!
XQuery by Priscilla Walmsley