.. highlightlang:: us

.. index:: nc_get_option

.. _nc_get_option:

nc_get_option
=============

.. us.tag  nc_get_option GERMAN NC New403 Changed542 Changed5145 Changed5508 Changed6200

:ref:`nc_get_option` erfragt eine Option.

.. function::  prop = nc_get_option(ncid, ssPropName)

.. us.return

**Returnwert**

*prop* ist der Wert der Eigenschaft, oder -1, wenn ein Fehler auftrat.

.. us.params

**Parameter**

.. uparam:: ncid

   *ncid* identifiziert die netCDF-Datei.

.. uparam:: ssPropName

   *ssPropName* ist der Wert:

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

      * - Wert
        - Bedeutung
      * - ``"nocase"``
        - Wenn *prop* 1 ist, wird bei den Funktionen :ref:`nc_varid`, 
          :ref:`nc_attget` nicht zwischen Groß- und Kleinbuchstaben unterschieden.
          Wenn *prop* 0 ist, wird zwischen Groß- und Kleinbuchstaben unterschieden.
      * - ``"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 is 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"``
        - siehe :ref:`nc_set_option`.
      * - ``"utf8"``
        - siehe :ref:`nc_set_option`.

.. us.example

**Beispiel**

::

   print nc_get_option(ncid, "nocase");

.. us.history

**History**

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

   * - 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"``.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_open`,
   :ref:`nc_set_option`

:sub:`id-243621`