nc_open

nc_open öffnet eine existierende Datendatei zum Lesen oder Schreiben.

ncid = nc_open(ssFileName)

ncid = nc_open(ssFileName, nOpenMode)

Returnwert

ncid ist eine Zugriffsnummer, die auf die erzeugte Datei verweist. Falls beim Öffnen der Datei ein Fehler auftritt, erhält ncid den Wert -1.

Parameter

ssFileName

ssFileName ist der Name der Datei die geöffnet werden soll.

nOpenMode

nOpenMode ist einer der folgenden Werte:

Wert	Bedeutung
NC_WRITE	Die Datei wird exklusiv zum Schreiben geöffnet.
NC_NOWRITE	Die Datei kann nur gelesen werden.

Falls nOpenMode nicht angegeben wird, wird NC_WRITE verwendet.

Kommentar

Ab R2012.1 Referenz-Zähler: Wenn die Datei ssFileName innerhalb eines Prozesses mehrfach geöffnet wird, bevor sie mit nc_close geschlossen wurde, liefert die Funktion immer die selbe ncid. Der Parameter nOpenMode wird ab dem zweiten Öffnen ignoriert. nc_open liefert nur die selbe ncid wenn die Schreibweise von ssFileName in allen Aufrufen exakt gleich ist.

Nach dem Öffnen mit NC_WRITE, kann die Datei von anderen Prozessen nur noch mit NC_NOWRITE geöffnet werden.

Schreibgeschützte Dateien können nur mit NC_NOWRITE geöffnet werden.

Beispiel

ncid = nc_open("d:\\dat\\test.nc", NC_NOWRITE);
if (ncid == -1) {
    error();
}
...
nc_close(ncid);

History

Version	Beschreibung
R2012.1 (5.40.1)	Referenzzähler-Technik, siehe Kommentar oben.
R2012 (5.40.0)	Aufruf mit einem Parameter. nOpenMode ist dann NC_WRITE.

Siehe auch

Überblick UniPlot-Datendateien, nc_create, nc_close, nc_abort, nc_sync

_id-1781578