.. highlightlang:: us

.. _nc_varinq_name:

nc_varinq_name
==============

.. index:: nc_varinq_name

.. us.tag  nc_varinq_name GERMAN NC_Var  Changed5145

:ref:`nc_varinq_name` erfragt den Namen einer netCDF-Variablen, wobei die
Identifikations-Nummer vorgegeben wird.

.. function::  ssName = nc_varinq_name(ncid, varid)
    ssName = nc_varinq_name(ncid, varid, bToUnderscore)

.. us.return

**Returnwert**

*ssName* ist der Name einer der netCDF-Variablen mit der Identifikations-Nummer
*varid*. Im Fehlerfall ist *ssName* eine leere 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 netCDF-Variablen.

.. 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
     - Optionaler 3. Parameter.

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

:sub:`id-522741`