home contribute faq download

FunctX XQuery Functions

functx:value-union

The union of two sequences of values

Google
Webxqueryfunctions.com

Description

The functx:value-union function returns the union of the values in two sequences in an implementation-defined order. It removes duplicates, even among the values that appear only in one of the sequences. This function is useful because the built-in union (or "|") operator only works on nodes, not atomic values.

Arguments and Return Type

NameTypeDescription
$arg1 xs:anyAtomicType* the first sequence
$arg2 xs:anyAtomicType* the second sequence
return value xs:anyAtomicType*

XQuery Function Declaration

See XSLT definition.
XQuery Syntax for January 2007 (1.0):
declare namespace functx = "http://www.functx.com"; 
declare function functx:value-union 
  ( $arg1 as xs:anyAtomicType* ,
    $arg2 as xs:anyAtomicType* )  as xs:anyAtomicType* {
       
  distinct-values(($arg1, $arg2))
 } ;
XQuery Syntax for July 2004 - November 2005 (CR):
declare namespace functx = "http://www.functx.com"; 
declare function functx:value-union 
  ( $arg1 as xdt:anyAtomicType* ,
    $arg2 as xdt:anyAtomicType* )  as xdt:anyAtomicType* {
       
  distinct-values(($arg1, $arg2))
 } ;
XQuery Syntax for May 2003:
declare namespace functx = "http://www.functx.com" 
define function value-union 
  ( $arg1 as xdt:anyAtomicType* ,
    $arg2 as xdt:anyAtomicType* )  as xdt:anyAtomicType* {
       
  fn:distinct-values(($arg1, $arg2))
 }

Examples

XQuery ExampleResults
functx:value-union((1,2),(3,4))
(1, 2, 3, 4)
functx:value-union((1,2,3),(2,3,4))
(1, 2, 3, 4)
functx:value-union((1,2,2,3),(3,4))
(1, 2, 3, 4)
functx:value-union((1,2,2,3),())
(1, 2, 3)

See Also

functx:value-intersectThe intersection of two sequences of values
functx:value-exceptThe values in one sequence that aren't in another sequence

History

Published OnLast UpdatedContributor(s)
2006-06-272007-02-26W3C XML Query Working Group, XQuery 1.0 and XPath 2.0 Functions and Operators, http://www.w3.org/TR/xpath-functions/
Need XQuery Help?
D A T Y P I C
Training | Consulting | Development

XQuery by Priscilla WalmsleyGet the book!
XQuery by Priscilla Walmsley