.. highlightlang:: us

.. _nc_makevalidname:

nc_makevalidname
================

.. index:: nc_makevalidname

.. us.tag  nc_makevalidname GERMAN NC_Var Changed5145

:ref:`nc_makevalidname` liefert einen gültigen netCDF Variablennamen für einen
gegebenen Namen.

.. function::  ssNewName = nc_makevalidname(ncid, ssName)
     ssNewName = nc_makevalidname(ncid, ssName, bToUnderscore)

.. us.return

**Returnwert**

*ssNewName* ist ein gültiger Variablenname.

Sonderzeichen im Namen werden durch Unterstriche ersetzt. Umlaute werden wie
folgt umgesetzt: Ä->A, ä->a, Ö->O, ö->o, Ü->U, ü->u, ß->s.
Ab UniPlot 5.14.5 dürfen die Kanalnamen die folgenden Sonderzeichen enthalten:
``.``, ``-``, ``+``, ``$``, ``#``, ``~``, ``!``, ``^``, ``&``, ``%``.

Im Fehlerfall hat *ssNewName* den Wert "".

.. 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. Falls für
   *ncid* der Wert -1 angegeben wird, wird nur ein gültiger Name zurückgegeben.

.. uparam:: ssName

   *ssName* ist der Name, für den ein gültiger Name erzeugt werden soll.

.. 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 -1. Beim Wert -1 werden die Einstellungen der Funktion
   :ref:`nc_set_option` verwendet.

.. us.comment

**Kommentar**

Falls für den Parameter *ncid* ein gültiger NC-Handle angegeben wird, liefert
die Funktion einen eindeutigen Namen, der mit keinem anderen Namen in der
NC-Datei übereinstimmt. Der Name wird dazu um einen Unterstrich gefolgt von einer
Nummer erweitert, falls der Name bereits in der Datei existiert.

.. 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:`nc_varid`,
   :ref:`nc_set_option`,
   :ref:`nc_vardef`

:sub:`id-1001849`