.. highlightlang:: us

.. index:: nc_attput

.. _nc_attput:

nc_attput
=========

.. us.tag  nc_attput GERMAN NC_Att

:ref:`nc_attput` fügt einer Variablen ein Attribut hinzu oder ändert ein
vorhandenes Attribut.

.. function::  r = nc_attput(ncid, varid, ssName, nDataType, values)
    r = nc_attput(ncid, varid, ssName, nDataType, values, bOverwrite)

.. us.return

**Returnwert**

*r* ist größer oder gleich 0 wenn die Funktion erfolgreich war und im Fehlerfall
kleiner als 0.

.. us.params

**Parameter**

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der
   Funktionen :ref:`nc_create` oder :ref:`nc_open` geliefert wurde.

.. uparam:: varid

   *varid* ist die Identiätsnummer (ID) der Variablen oder ``NC_GLOBAL`` (-1)
   für ein globales Attribut. Die Variablen ID beginnt mit 0.

.. uparam:: ssName

   *ssName* ist der Name des Attributs. Der Name muss mit einem Buchstaben
   beginnen, gefolgt von 0 oder mehr Buchstaben oder Zahlen sowie dem Unterstrich 
   (``_``). Groß- und Kleinbuchstaben werden unterschieden.

.. uparam:: nDataType

   *nDataType* ist der Datentyp des Attributs. Er kann folgende Werte annehmen:

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

      * - Wert
        - Bedeutung
      * - NC_BYTE
        - Ein Byte
      * - NC_CHAR
        - Ein Zeichen
      * - NC_SHORT
        - 16-Bit Integer
      * - NC_LONG
        - 32-Bit Integer
      * - NC_FLOAT
        - 32-Bit Fließkommazahl
      * - NC_DOUBLE
        - 64-Bit Fließkommazahl

.. uparam:: values

   *values* sind die Werte des Attributs. *values* kann ein Spalten- oder
   Zeilenvektor sein.

.. uparam:: bOverwrite

   Falls *bOverwrite* auf den Wert TRUE (1) gesetzt wird, wird der Wert des
   Attributs überschrieben. Falls *bOverwrite* auf den Wert FALSE (0) gesetzt
   wird, wird ein neues Attribut erzeugt (Default). Durch eine an den Namen
   angehängte Zahl wird ein eindeutiger Attributname erzeugt.

.. us.comment

**Kommentar**

Die Datei muss sich im Definitions-Modus befinden (siehe :ref:`nc_redef`).

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`data-channel-attributes`,
   :ref:`nc_create`,
   :ref:`nc_attget`,
   :ref:`nc_inquire_ngatts`,
   :ref:`nc_varinq_natts`,
   :ref:`nc_attinq_datatype`,
   :ref:`nc_attinq_len`,
   :ref:`nc_attname`

:sub:`id-550528`