FunctX XQuery Function Library > Sequences > Combining >

functx:value-except

The values in one sequence that aren't in another sequence

Description

The functx:value-except function returns the values in one sequence that do not appear in the second sequence, in an implementation-defined order. It removes duplicates, even among the values that appear only in the first sequence. This function is useful because the built-in except operator only works on nodes, not atomic values.

Arguments and Return Type

XQuery Function Declaration

declare namespace functx = "http://www.functx.com";
declare function functx:value-except
  ( $arg1 as xs:anyAtomicType* ,
    $arg2 as xs:anyAtomicType* )  as xs:anyAtomicType* {

  distinct-values($arg1[not(.=$arg2)])
 } ;

Examples

functx:value-except((1,2,3),(3,4,5))

(1, 2)

functx:value-except((1,1,2,3),(2,3))

1

functx:value-except((1,2),(3,4))

(1, 2)

functx:value-except((1,2,2,3),())

(1, 2, 3)

See Also

History