.. highlightlang:: us

.. _nc_varput_missing:

nc_varput_missing
=================

.. index:: nc_varput_missing

.. us.tag  nc_varput_missing GERMAN NC_Var New330

:ref:`nc_varput_missing` schreibt Daten in eine
netCDF-Variable in eine geöffnete netCDF-Datei, die sich im
Daten-Modus befinden muss. Fehlende Werte müssen den Wert
``MISSING_VALUE`` enthalten.

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

.. us.return

**Returnwert**

*r* hat den Wert -1, falls ein Fehler beim Schreiben
auftritt.

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

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

.. uparam:: bCharAsByte

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

.. us.comment

**Kommentar**

Die Funktion entspricht der Funktion :ref:`nc_varput`. Beim Schreiben 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.
Falls das Attribut nicht in der NC-Datei vorhanden ist, wird für Daten im Format
``NC_FLOAT`` der Wert ``MISSING_FLOAT`` und für
``NC_DOUBLE`` der Wert ``MISSING_DOUBLE`` verwendet.

.. us.example

**Beispiel**

::

   ncid = nc_create("d:/test.nc");
   dimid = nc_dimdef(ncid, "n", 8);
   varid = nc_vardef(ncid, "channel", NC_FLOAT, dimid);
   nc_attput(ncid, varid, "missing_value", NC_FLOAT, -99);
   nc_endef(ncid);
   // translate MISSING_VALUE (10e10) to -99
   nc_varput_missing(ncid, varid, 3, 4, [3,MISSING_VALUE,5,6]);
   nc_close(ncid);

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`nc_dimdef`,
   :ref:`nc_vardef`,
   :ref:`nc_endef`,
   :ref:`nc_redef`,
   :ref:`nc_close`,
   :ref:`nc_varget`,
   :ref:`nc_varget_missing`,
   :ref:`nc_varput`,
   :ref:`strcode`

:sub:`id-1253990`