.. highlightlang:: us

.. index:: nc_attget

.. _nc_attget:

nc_attget
=========

.. us.tag  nc_attget GERMAN NC_Att

Mit :ref:`nc_attget` können Attributwerte von Variablen erfragt werden.

.. function::  values = nc_attget(ncid, varid, ssName)

.. us.return

**Returnwert**

*values* ist eine Zeichenkette, eine Zahl oder ein Vektor oder -1, falls das
Attribut nicht existiert.

.. 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 Identifikations-Nummer einer Variablen. Wenn ein globales
   Attribut erfragt werden soll, ist *varid* gleich -1.

.. uparam:: ssName

   *ssName* ist der Name des Attributes.

.. us.comment

**Kommentar**

Mit der Funktion :ref:`nc_attinq_datatype` kann man prüfen, ob ein Attribut
existiert. Falls das angegebene Attribut nicht existiert, liefert die Funktion
den Wert -1.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`data-channel-attributes`,
   :ref:`nc_attput`,
   :ref:`nc_create`,
   :ref:`nc_attinq_datatype`

:sub:`id-628025`