nc_open öffnet eine existierende Datendatei zum Lesen oder Schreiben.
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 ist der Name der Datei die geöffnet werden soll.
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. |
| NC_SWRITE | (Geplant) Ist eine Abkürzung für NC_SHARE|NC_WRITE. Die Datei wird zum Schreiben geöffnet, ohne sie zu sperren. Siehe Kommentar. |
| NC_SNOWRITE | (Geplant)Ist eine Abkürzung für NC_SHARE|NC_NOWRITE. Die Datei wird zum Lesen geöffnet, ohne sie zu sperren. Siehe Kommentar. |
Falls nOpenMode nicht angegeben wird, wird NC_WRITE verwendet.
Kommentar
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.
(Geplant) Beim Öffnen mit NC_SWRITE oder NC_SNOWRITE wird die Datei nicht sofort gesperrt. Die Datei wird erst beim Aufruf von nc_lock gesperrt und beim Aufruf von nc_unlock entsperrt. Die Funktionen zum Lesen und Schreiben, wie nc_varget oder nc_varput verwenden nc_lock und nc_unlock intern. nc_lock verhindert das Lesen und Schreiben anderer Prozesse auf die Datei.
Beispiel
ncid = nc_open("d:\\dat\\test.nc", NC_NOWRITE);
if (ncid == -1) {
error();
}
...
nc_close(ncid);
History
| Version | Beschreibung |
|---|---|
| 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_lock, nc_unlock, nc_sync
id-1781578