.. highlightlang:: us

.. index:: nc_varsearch

.. _nc_varsearch:

nc_varsearch
============

.. us.tag  nc_varsearch GERMAN NC_Var New5400

:ref:`nc_varsearch` sucht den Index des größten Wertes in *varid*, der kleiner
oder gleich x ist. Die Werte in *varid* müssen monoton aufsteigend sortiert sein
und dürfen keine Missing-Values enthalten.

.. function::  index = nc_varsearch(ncid, varid, x)

.. us.return

**Returnwert**

*index* ist der Punkt für den gilt var[index] <= x < var[index+1]. *index* ist ein
Wert im Bereich 0 .. n-1.

Im Fehlerfall liefert die Funktion eine Zahl < 0 zurück.  Mit der Funktion 
:ref:`nc_last_error` kann dann der Fehlercode abgefragt werden.

.. us.params

**Parameter**

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der
   Funktionen :ref:`nc_create` oder :ref:`nc_open` geliefert wurde.

.. uparam:: varid

   *varid* ist die Identifikations-Nummer einer Variablen.

.. uparam:: x

   *x* ist eine Koordinate deren Vorgänger-Index gesucht werden soll.

.. us.comment

**Kommentar**

Diese Funktion kann nur bei UniPlot-Datendateien verwendet werden. Siehe 
:ref:`nc_create`. 

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2012 (5.40.0)
     - Neu

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_open`,
   :ref:`nc_last_error`,
   :ref:`nc_varinq_info`,
   :ref:`error_create`

:sub:`id-1626420`