.. highlightlang:: us

.. index:: NC_GetVarNames

.. _nc_getvarnames:

NC_GetVarNames
==============

.. us.tag  NC_GetVarNames GERMAN nc.tools Changed5145

:ref:`NC_GetVarNames` liefert die Namen der Variablen einer netCDF Datei (NC-Datei). 

.. function::  svVarNames = NC_GetVarNames(ssNCName)
    svVarNames = NC_GetVarNames(ncid)
    svVarNames = NC_GetVarNames(ssNCName, dimid)
    svVarNames = NC_GetVarNames(ncid, dimid)
    svVarNames = NC_GetVarNames(ssNCName, dimid, bOnlyRealChannels)
    svVarNames = NC_GetVarNames(ncid, dimid, bOnlyRealChannels)
    svVarNames = NC_GetVarNames(ssNCName, dimid, bOnlyRealChannels, bToUnderscore)
    svVarNames = NC_GetVarNames(ncid, dimid, bOnlyRealChannels, bToUnderscore)

.. us.return

**Returnwert**

Ist ein String-Vektor mit den Variablennamen der angegebenen NC-Datei.
Falls die Datei nicht geöffnet werden konnte, liefert die Funktion 
einen leeren String zurück.

.. us.params

**Parameter**

.. uparam:: ssNCName

   *ssNCName* ist der Name einer netCDF Datei.

.. uparam:: ncid

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

.. uparam:: dimid

   *dimid* ist die Identifikations-Nummer einer Dimension.
   Falls dieser Wert eine gültige Dimensionsnummer enthält, liefert die 
   Funktion nur die Variablen der angegebenen Dimension zurück. Falls 
   der Wert -1 übergeben wird, liefert die Funktion alle Variablen zurück.
   Defaultwert ist -1.

.. uparam:: bOnlyRealChannels

   Falls *bOnlyRealChannels* = TRUE (1) ist, werden Variablen
   vom Type NC_CHAR ignoriert. Defaultwert ist FALSE (0).

.. uparam:: bToUnderscore

   Falls *bToUnderscore* = TRUE (1) ist, werden die Sonderzeichen im Kanalnamen
   durch Unterstriche ersetzt. Beim Wert 0 bleiben die Sonderzeichen erhalten.
   Gültige Sonderzeichen: 
   ``.``, ``-``, ``+``, ``$``, ``#``, ``~``, ``!``, ``^``, ``&``, ``%``
   Defaultwert ist FALSE (0).

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.14.5
     - Neuer Parameter bToUnderscore.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`DialogBox`,
   :ref:`CreateListBoxText`,
   :ref:`NC_GetVarAttribs`

:sub:`id-1601970`