.. highlightlang:: us .. index:: nc_open .. _nc_open: nc_open ======= .. us.tag nc_open GERMAN NC_open Changed5400 Changed5401 :ref:`nc_open` öffnet eine existierende Datendatei zum Lesen oder Schreiben. .. function:: ncid = nc_open(ssFileName) ncid = nc_open(ssFileName, nOpenMode) .. us.return **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. .. us.params **Parameter** .. uparam:: ssFileName *ssFileName* ist der Name der Datei die geöffnet werden soll. .. uparam:: nOpenMode *nOpenMode* ist einer der folgenden Werte: .. list-table:: :header-rows: 1 * - 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. .. us.comment **Kommentar** Ab R2012.1 Referenz-Zähler: Wenn die Datei *ssFileName* innerhalb eines Prozesses mehrfach geöffnet wird, bevor sie mit :ref:`nc_close` geschlossen wurde, liefert die Funktion immer die selbe *ncid*. Der Parameter *nOpenMode* wird ab dem zweiten Öffnen ignoriert. :ref:`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. .. us.example **Beispiel** :: ncid = nc_open("d:\\dat\\test.nc", NC_NOWRITE); if (ncid == -1) { error(); } ... nc_close(ncid); .. us.history **History** .. list-table:: :header-rows: 1 * - 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``. .. seealso:: :ref:`uberblick-netcdf-dateien`, :ref:`nc_create`, :ref:`nc_close`, :ref:`nc_abort`, :ref:`nc_sync` :sub:`id-1781578`