.. highlightlang:: us

.. _error_create:

error_create
============

.. index:: error_create

.. us.tag  error_create NOTREADYGERMAN New410

:ref:`error_create` erzeugt ein Error-Objekt.

.. function::  e = error_create(domain, code, message)

.. us.return

**Returnwert**

*e* ist ein Error-Objekt.

.. us.params

**Parameter**

.. uparam:: domain

   *domain* ist die Gruppe zu der der Fehler gehört, z. B. "file-error".

.. uparam:: code

   *code* ist die Fehler-Nummer. Die Fehlernummer ist nur innerhalb einer 
   Gruppe eindeutig.

.. uparam:: message

   *message* ist die Fehlermeldung (Zeichenkette).

.. us.comment

**Kommentar**

Die 3 Variablen des Error-Objekts können über die "Punkt-Schreibweise" gesetzt
oder erfragt werden, z. B. ``e.message = "file not found";``. 

.. us.example

**Beispiel**

::

   def test()
   {
       o = obj_create();
       e = o.load("d:/laksjdlksajd");
       if (type(e) == "error") {
           MessageBoxError("%s\n\nError-No.: %d\n%s", e.domain, e.code, e.message);
           return e;
       }
       return 0;
   }

Verwendung von :ref:`error_create` in einer UniScript-Funktion:

::

   def test(a, b)
   {
       if (argsin() != 2) {
           return error_create("test-error", 1, "no of args must be 2");
       }
       return a+b;
   }

Der Anwender der Funktion test() kann den Returnwert der Funktion nun überprüfen:

::

   res = test(1)
   if (type(res) == "error") {
       MessageBox(res.message);
       ...
   }
   ...

.. seealso::
   :ref:`uberblick-programmierung`,
   :ref:`type`

:sub:`id-1376826`