.. highlightlang:: us

.. _xyfind:

XYFind
======

.. index:: XYFind

.. us.tag  XYFind GERMAN xy.data

:ref:`XYFind` sucht in einem 2D-Datensatz einen
Datenpunkt.

.. function::  rvInfo = XYFind(hData, rsX, bInterpol)

.. us.return

**Returnwert**

*rvInfo* ist ein Vektor mit 3 Elementen oder 0, falls kein
Punkt gefunden werden konnte.

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

   * - Wert
     - Bedeutung
   * - rvInfo[1]
     - Index des Datenpunktes, beginnend bei 1
   * - rvInfo[2]
     - x-Koordinate des Datenpunktes
   * - rvInfo[3]
     - y-Koordinate des Datenpunktes

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des
   Datensatzes, der mit :ref:`XYCreate` oder :ref:`TYCreate` erzeugt wurde.

.. uparam:: rsX

   *rsX* x-Koordinate des gesuchten Datenpunktes.

.. uparam:: bInterpol

   Falls *bInterpol* den Wert TRUE (1) hat, liefert
   die Funktion für die x-Koordinate eine linear interpolierte
   y-Koordinate. Falls *bInterpol* den Wert FALSE (1) hat
   (Defaultwert), liefert die Funktion für die x-Koordinate die
   x,y-Koordinaten des nächst liegenden Datenpunktes.

.. us.comment

**Kommentar**

Die Daten müssen monoton aufsteigende oder absteigende x-Koordinaten haben.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.6.4
     - *rvInfo* korrigiert.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYCreate`

:sub:`id-1097999`