.. highlightlang:: us

.. index:: nc_set_option

.. _nc_set_option:

nc_set_option
=============

.. us.tag  nc_set_option GERMAN NC New403 Changed427 Changed542 Changed5145 Changed5508 Changed6200

:ref:`nc_set_option` setzt eine Option.

.. function::  ret = nc_set_option(ncid, ssPropName, prop)

.. us.return

**Returnwert**

Wenn *ret* -1 ist, ist ein Fehler aufgetreten.

.. us.params

**Parameter**

.. uparam:: ncid

   *ncid* identifiziert die netCDF-Datei. Falls *ncid* gleich -1 ist, wird die
   Eigenschaft global geändert.

.. uparam:: ssPropName

   *ssPropName* ist der Wert:

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

      * - Wert
        - Bedeutung
      * - ``"utf8"``
        -
      * - ``"nocase"``
        - Wenn *prop* 1 ist, wird bei den Funktionen :ref:`nc_varid`,
          :ref:`nc_attget` nicht zwischen Groß- und Kleinbuchstaben
          unterschieden. Falls  *prop* gleich 0 ist werden Groß-/Kleinbuchstaben
          unterschieden. Falls *prop* gleich -1 ist, wird die globale Einstellung
          verwendet.
      * - ``"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
          ist 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"``
        - Wenn *prop* 1 ist, werden NC2-Dateien exklusiv geöffnet, ohne das
          andere Prozesse auf die Datei zugreifen können. Diese Option sollte 
          eingeschaltet werden, wenn z.B. fehlerhafte Virenscanner auf die
          NC2-Dateien zugreifen.

.. us.example

**Beispiel**

::

   nc_set_option(ncid, "nocase", 1);

.. 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"``.
   * - 4.2.7
     - *ncid* kann -1 sein, dann wird die Eigenschaft für alle *ncid* verwendet.

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

:sub:`id-244453`