.. highlightlang:: us

.. index:: error

.. _error:

error
=====

.. us.tag  error GERMAN Programming.Exceptions

:ref:`error` gibt eine Fehlermeldung in das Kommando-Fenster aus und beendet alle
laufenden Funktionen.

.. function::  error()
               error(ssMessage)

.. us.return

**Returnwert**

Die Funktion kehrt nicht zum Aufrufer zurück und hat damit auch keinen
Return-Wert.

.. us.params

**Parameter**

.. uparam:: ssMessage

   *ssMessage* ist ein String, der in das Kommando-Fenster und/oder in ein
   Meldungsfenster (siehe :ref:`config`) ausgegeben wird.

   Das Meldungsfenster wird nicht erzeugt, wenn die Ausnahme abgefangen wird,
   siehe :ref:`try-except <try>`.

.. us.comment

**Kommentar**

:ref:`error` erzeugt eine Ausnahme (ICERR_USER_ERROR), die mit den
Ausnahme-Behandlungs-Mechanismen von UniScript abgefangen werden kann. Siehe
:ref:`try-except <try>`.

.. us.example

**Beispiel**

::

   def read_text_file(ssFileName)
   {
     if (nargsin() == 0) {
         error("missing filename")
     }
     fp = fopen(ssFileName, "r");
     if (fp == 0) {
         error("cannot open " + ssFileName)
     }
     ssText = fread(fp, "char");
     flose(fp);
     return ssText;
   }

.. seealso::
   :ref:`uberblick-programmierung`,
   :ref:`GetExceptionCode`,
   :ref:`GetExceptionInfo`,
   :ref:`config`,
   :ref:`try-except <try>`

:sub:`id-918964`