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. |
Siehe auch
Überblick UniPlot-Datendateien, nc_create, nc_varid, nc_set_option, nc_vardef
id-1001849