.. highlightlang:: us

.. _nc_dimdef:

nc_dimdef
=========

.. index:: nc_dimdef

.. us.tag  nc_dimdef GERMAN NC_Dim

:ref:`nc_dimdef` fügt einer netCDF-Datei eine neue Dimension hinzu. Die
netCDF-Datei muss sich dazu im Definitions-Modus befinden (siehe 
:ref:`nc_endef`/:ref:`nc_redef`).

.. function::  dimid = nc_dimdef(ncid, ssName, nSize)

.. us.return

**Returnwert**

Im Fehlerfall hat *dimid* den Wert -1, sonst einen Wert >= 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:: ssName

   *ssName* ist der Name der Dimension.

.. uparam:: nSize

   *nSize* ist die Größe der Dimension.

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

:sub:`id-1793043`