.. highlightlang:: us

.. index:: nc_fatal_error

.. _nc_fatal_error:

nc_fatal_error
==============

.. us.tag  nc_fatal_error GERMAN NC New560

:ref:`nc_fatal_error` liefert den Fehlercode des ersten fatalen Fehlers oder den
Wert 0, falls kein fataler Fehler aufgetreten ist.

.. function::  ncerr = nc_fatal_error(ncid)

.. us.return

**Returnwert**

*ncerr*  ist Fehlercode des ersten fatalen Fehlers, der bei der angegebenen 
*ncid*  aufgetreten ist.

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

.. us.comment

**Kommentar**

Diese Funktion kann nur bei UniPlot-Datendateien (NC2) verwendet werden. 
Siehe :ref:`nc_create`. Bei nectCDF-Dateien (NC_FORMAT_CLASSIC und NC_FORMAT_PC)
liefert die Funktion immer -1.

Nach einem fatalen Fehler führt der Aufruf von :ref:`nc_close` intern zum Aufruf
von :ref:`nc_abort`, d. h. alle Änderungen seit dem Öffnen der Datei bzw. dem
letzten  :ref:`nc_sync`-Aufruf gehen verloren. Fatale Fehler können bei
Netzwerkstörungen,  mangelndem Festplattenplatz oder Speicherproblemen auftreten.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.6.0
     - Neu

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_last_error`,
   :ref:`nc_str_error`

:sub:`id-469251`