.. highlightlang:: us

.. _tyadddata:

TYAddData
=========

.. index:: TYAddData

.. us.tag  TYAddData NOTREADYGERMAN ty.data New400 Changed530 Changed5200

:ref:`TYAddData` fügt einem t/y-Datensatz (1D-Datensatz) Daten zu. 

.. function::  bool = TYAddData(hData, rvY)
    bool = TYAddData(hData, rvY, bExt)
    bool = TYAddData(hData, rvY, bExt, rsMissingValue)

.. us.return

**Returnwert**

*bool*.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer eines Datensatzes.

.. uparam:: rvY

   *rvY* ist ein Vektor mit den Y-Koordinaten.

.. uparam:: bExt

   Der Parameter legt fest, ob die Funktion auf die Originaldaten oder die 
   gefilterten Daten zugreift.

   .. list-table::
      :header-rows: 1

      * - Wert
        - Beschreibung
      * - -1
        - Falls gefilterte Daten vorhanden sind: Zugriff auf die gefilterten Daten, sonst auf die Originaldaten. Der Defaultwert ist -1.
      * - 0
        - Zugriff auf die Originaldaten.
      * - 1
        - Zugriff auf die gefilterten Daten.

.. uparam:: rsMissingValue

   *rvMissingValue* legt einen ungültigen Wert fest. Die 
   ungültigen Werte werden in *rvY* ignoriert.
   Default-Wert ist 1e10.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.20.0
     - Neuer Parameter *rvMissingValue*.
   * - 5.3.0
     - ???

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`TYCreate`,
   :ref:`TYSetData`,
   :ref:`XYIsTYDataset`,
   :ref:`XYAddData`

:sub:`id-1140306`