.. highlightlang:: us

.. index:: nc_varget_missing

.. _nc_varget_missing:

nc_varget_missing
=================

.. us.tag  nc_varget_missing GERMAN NC_Var New330

:ref:`nc_varget_missing` liest Daten einer Variablen aus einer netCDF-Datei.
Fehlende Werte werden auf den Wert MISSING_VALUE gesetzt. Die Datei muss sich im
Daten-Modus befinden.

.. function::  values = nc_varget_missing(ncid, varid)
    values = nc_varget_missing(ncid, varid, rvStart, rvCount)
    values = nc_varget_missing(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 Schreiben
   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 schreibender 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 (Datentype = 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.

Die Funktion entspricht der Funktion :ref:`nc_varget`. Beim Lesen der Daten
werden jedoch Zahlenwerte, die den Wert ``missing_value`` enthalten, in
missing values umgesetzt, wie in der Datei durch das Attribut ``missing_value``
vorgegeben.

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

:sub:`id-1255526`