nc_set_option

nc_set_option setzt eine Option.

ret = nc_set_option(ncid, ssPropName, prop)

Returnwert

Wenn ret -1 ist, ist ein Fehler aufgetreten.

Parameter

ncid

ncid identifiziert die netCDF-Datei. Falls ncid gleich -1 ist, wird die Eigenschaft global geändert.

ssPropName

ssPropName ist der Wert:

Wert Bedeutung
"utf8"  
"nocase" Wenn prop 1 ist, wird bei den Funktionen nc_varid, nc_attget nicht zwischen Groß- und Kleinbuchstaben unterschieden. Falls prop gleich 0 ist werden Groß-/Kleinbuchstaben unterschieden. Falls prop gleich -1 ist, wird die globale Einstellung verwendet.
"umlaut_to_underscore" Wenn prop 1 ist, werden Umlaute in Kanalnamen und Attributnamen durch einen Unterstrich ersetzt. Wenn prop 0 ist, werde die Umlaute wie folgt umgesetzt: Ä->A, ä->a, Ö->O, ö->o, Ü->U, ü->u, ß->s. Default-Wert ist 0. Aufgrund eines Programmfehlers in UniPlot 5.0.0 bis 5.4.1 wurden Umlaute durch einen Unterstrich ersetzt. Mit Hilfe dieser Option kann das Verhalten wieder hergestellt werden. Die Option kann nur global gesetzt werden (ncid = -1).
"allow_special_chars" Wenn prop 1 ist, werden die folgenden 10 Zeichen in Kanal- und Attributnamen akzeptiert: ., -, +, $, #, ~, !, ^, &, %.
"nc2_no_write_share" Wenn prop 1 ist, werden NC2-Dateien exklusiv geöffnet, ohne das andere Prozesse auf die Datei zugreifen können. Diese Option sollte eingeschaltet werden, wenn z.B. fehlerhafte Virenscanner auf die NC2-Dateien zugreifen.

Beispiel

nc_set_option(ncid, "nocase", 1);

History

Version Beschreibung
R2020.0 Neue Option "utf8".
R2013.8 Neue Option "nc2_no_write_share".
5.14.5 Neue Option "allow_special_chars".
5.4.2 Neue Option "umlaut_to_underscore".
4.2.7 ncid kann -1 sein, dann wird die Eigenschaft für alle ncid verwendet.

id-244453