nc_makevalidname

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

ssNewName = nc_makevalidname(ncid, ssName)
ssNewName = nc_makevalidname(ncid, ssName, bToUnderscore)

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 „“.

Parameter

ncid

ncid ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der Funktionen nc_create oder nc_open geliefert wurde. Falls für ncid der Wert -1 angegeben wird, wird nur ein gültiger Name zurückgegeben.

ssName

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

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 nc_set_option verwendet.

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.

History

Version Beschreibung
5.14.5 Neuer Parameter bToUnderscore.

id-1001849