.. _functx_value-except:

===================
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.

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

   * - **Parameters**
     - **Description**
   * - arg1:string()
     - the first sequence
   * - arg2:string()
     - the second sequence

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

   * - **XPath**
     - **Results**
   * - 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
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_value-union`.
* :ref:`functx_value-intersect`.