.. highlightlang:: us

.. index:: log_error
.. index:: log_trace
.. index:: log_debug
.. index:: log_info
.. index:: log_warning
.. index:: log_fatal

.. _log_error:

log_error
=========

.. us.tag  log_error NOTREADYGERMAN New500 Programming.Logging

:ref:`log_error` gibt eine Logging-Meldung aus.

.. function::  bool = log_trace(ssLogger, ssSource, ssMessage, ...)
    bool = log_debug(ssLogger, ssSource, ssMessage, ...)
    bool = log_info(ssLogger, ssSource, ssMessage, ...)
    bool = log_warning(ssLogger, ssSource, ssMessage, ...)
    bool = log_error(ssLogger, ssSource, ssMessage, ...)
    bool = log_fatal(ssLogger, ssSource, ssMessage, ...)

.. us.return

**Returnwert**

*bool* ist TRUE, wenn die Funktion erfolgreich war und sonst FALSE.

.. us.params

**Parameter**

.. uparam:: ssLogger

   *ssLogger* ist der Name des Loggers. Falls ein leerer String ("") angegeben
   wird, wird der Logger "uniscript" verwendet.

.. uparam:: ssSource

   *ssSource* ist ein String der beschreibt, wo das Ereignis aufgetreten ist. Es
   kann ein leerer String ("") angegeben werden.

.. uparam:: ssMessage

   *ssMessage* ist die Logging-Meldung. Der String kann eingebettete 
   Formatierungzeichen enthalten. Hinter *ssMessage* können dann weitere Argumente 
   angegeben werden. Siehe Beispiel und Beschreibung der Funktion :ref:`sprintf`. 

.. us.example

**Beispiel**

::

   n = 4;
   log_trace("uniscript", "", "Number of Points: %d", n);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Neu

.. seealso::
   :ref:`overview-logging`,
   :ref:`log_add_logger`,
   :ref:`log_get_logger_names`,
   :ref:`log_get_filename`,
   :ref:`log_set_filename`,
   :ref:`log_is_active`,
   :ref:`log_set_active`,
   :ref:`log_get_level`,
   :ref:`log_set_level`

:sub:`id-1148088`