.. highlightlang:: us

.. index:: nc_varget

.. _nc_varget:

nc_varget
=========

.. us.tag  nc_varget GERMAN NC_Var

:ref:`nc_varget` liest Daten einer Variablen aus einer netCDF-Datei, die sich dazu
im Daten-Modus befinden muss.

.. function::  values = nc_varget(ncid, varid)
    values = nc_varget(ncid, varid, rvStart, rvCount)
    values = nc_varget(ncid, varid, rvStart, rvCount, bCharAsByte)

.. us.return

**Returnwert**

*values* ist ein Vektor oder eine Matrix von Zahlen oder eine Zeichenkette.

.. 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:: rvStart

   *rvStart* ist ein Vektor mit Werten, der die Startpositionen für das Lesen
   der Daten festlegt. Die Vektor-Elemente müssen den Dimensionen  der Variablen in
   Reihenfolge und Anzahl entsprechen. Die Startpositionen beginnen bei 0.

.. uparam:: rvCount

   *rvCount* ist ein Vektor, der die Anzahl zu lesende Werte definiert. Der
   Vektor-Elemente müssen den Dimensionen der Variablen in Reihenfolge und Anzahl
   entsprechen. Die Anzahl muss mindestens 1 betragen.

.. uparam:: bCharAsByte

   Falls *bCharAsByte* TRUE (1) ist, werden die Buchstaben (Datentyp gleich 
   NC_CHAR) als byte-Werte zurückgegeben. Für andere Datentypen hat der Parameter
   keine Bedeutung. Default Wert ist FALSE (0).

.. us.comment

**Kommentar**

Falls die Dimension 1 ist, wird ein Zeilen-Vektor zurückgegeben.
Falls die Dimension 2 ist, wird eine Matrix zurückgegeben, und falls
die Dimension größer als 2 ist, wird ein Spalten-Vektor zurückgegeben.
Beim Datentyp NC_CHAR wird ein skalare Zeichenkette zurück gegeben.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`nc_open`,
   :ref:`nc_endef`,
   :ref:`nc_redef`,
   :ref:`nc_varput`,
   :ref:`strchar`,
   :ref:`auto_GetData`

:sub:`id-545369`