.. highlightlang:: us

.. _nc_vardef:

nc_vardef
=========

.. index:: nc_vardef

.. us.tag  nc_vardef GERMAN NC_Var

:ref:`nc_vardef` fügt ein neue Variable in die
offene netCDF Datei ein. Die Datei muss sich dazu im Definitions-Modus
befinden.

.. function::  varid = nc_vardef(ncid, ssName, nDataType, rvDimids)

.. us.return

**Returnwert**

*varid* ist die Identifikations-Nummer der Variablen. Im Fehlerfall
hat *varid* den Wert -1.

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

   *ssName* ist der Name der Variablen. Der Name muss
   mit einem Buchstaben oder einem Unterstrich beginnen, gefolgt von 0
   oder mehr Buchstaben oder Zahlen sowie dem Unterstrich(``_``).
   Ab UniPlot 5.14.5 dürfen die Kanalnamen die folgenden Sonderzeichen enthalten:
   ``.``, ``-``, ``+``, ``$``, ``#``, ``~``, ``!``, ``^``, ``&``, ``%``.
   Groß- und Kleinbuchstaben werden unterschieden. Sonderzeichen im Namen werden
   durch Unterstriche ersetzt. Umlaute werden wie folgt umgesetzt: Ä->A,
   ä->a, Ö->O, ö->o, Ü->U, ü->u, ß->s.

.. uparam:: nDataType

   *nDataType* ist der Datentyp der Variablen:
   ``NC_BYTE``, ``NC_CHAR``, ``NC_SHORT``, ``NC_LONG``, ``NC_FLOAT``, ``NC_DOUBLE``.

.. uparam:: rvDimids

   *rvDimids* ist ein Vektor von Dimensions
   Identifikations-Nummern.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`

:sub:`id-1963459`