.. highlightlang:: us

.. index:: ST_complement

.. _st_complement:

ST_complement
=============

.. us.tag  ST_complement NOTREADYGERMAN STR New300 Changed412

:ref:`ST_complement` berechnet das Komplement von *a* in *b*, das sind die
Elemente von *b*, die nicht in *a* sind oder 0 (real) oder "" (string).

.. function::  c = ST_complement(a, b)
    c = ST_complement(a, b, rsNull)

.. us.return

**Returnwert**

*c* ist ein Vektor mit den Elementen von *b*, die nicht in *a* sind.

.. us.params

**Parameter**

.. uparam:: a

   *a* ist ein Stringvektor oder Zahlenvektor.

.. uparam:: b

   *b* ist ein Stringvektor oder Zahlenvektor.

.. uparam:: rsNull

   *rsNull* ist ein Wert, der von der Funktion zurück gegeben wird, wenn alle
   Elemente in *b* in *a* enthalten sind. Der dritte  Parameter wird nur bei
   Zahlenvektoren verwendet.

.. us.example

**Beispiel**

::

   * ST_complement([2,3,5,7], [2,4,9])
   *    4.000    9.000
   *
   * ST_complement(["one", "two", "three"], ["two", "four", "five"])'
   four
   five
   *
   * ST_complement([2,5], [1,2,3,4,5,6])
       1.0000     3.0000     4.0000     6.0000 

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`ST_intersection`,
   :ref:`ST_set`,
   :ref:`ST_union`

:sub:`id-975428`