.. highlightlang:: us

.. index:: nc_vardelete

.. _nc_vardelete:

nc_vardelete
============

.. us.tag  nc_vardelete GERMAN NC_Var New560

:ref:`nc_vardelete` löscht eine Variable. Die Datei darf sich dazu nicht im
Definitions-Modus befinden.

.. function::  ret = nc_vardelete(ncid, ssName)

.. us.return

**Returnwert**

Im Fehlerfall hat *ret* den Wert -1, sonst ungleich -1.

.. 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:: ssName

   *ssName* ist der Name der Variablen.

.. 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
   * - 5.6.0
     - Neu

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`nc_redef`

:sub:`id-171309`