.. highlightlang:: us

.. index:: nc_inquire_mode

.. _nc_inquire_mode:

nc_inquire_mode
===============

.. us.tag  nc_inquire_mode GERMAN NC New5400

:ref:`nc_inquire_mode` erfragt den Mode einer offenen Datendatei.

.. function::  mode = nc_inquire_mode(ncid)

.. us.return

**Returnwert**

*mode* ist einer der folgenden Werte:

.. list-table::
   :header-rows: 0

   * - NC_NOWRITE
     - 0
     - Lesemode.
   * - NC_WRITE
     - 1
     - Die Datei ist zum Lesen und Schreiben geöffnet.

.. us.params

**Parameter**

.. uparam:: ncid

   *ncid* identifiziert die Datendatei.

.. us.example

**Beispiel**

::

   def test_nc_inquire_mode()
   {
        ncid = nc_create(GetUserDirectory() + "test.nc");

        mode = nc_inquire_mode(ncid);
        nc_close(ncid);
        if (mode == -1) {
            print "error";
            return;
        }
        if (mode & NC_WRITE) {
            print "NC_WRITE";
        } else {
            print "NC_NOWRITE";
        }
   }

.. us.comment

**Kommentar**

Diese Funktion kann nur bei UniPlot-Datendateien (nc2) verwendet werden. Siehe 
:ref:`nc_create`. 

Bei netCDF-Dateien (``NC_FORMAT_CLASSIC`` und ``NC_FORMAT_PC``) liefert die
Funktion immer -1.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2012 (5.40.0)
     - Neu.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_open`,
   :ref:`nc_create`,
   :ref:`nc_close`
   :ref:`nc_filename`

:sub:`id-1802651`