.. highlightlang:: us

.. index:: log_set_filename

.. _log_set_filename:

log_set_filename
================

.. us.tag  log_set_filename NOTREADYGERMAN New500 Programming.Logging

:ref:`log_set_filename` setzt den Namen der Ausgabedatei für alle Logger.

.. function::  bool = log_set_filename(ssLogFileName)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: ssLogFileName

   *ssLogFileName* ist der vollständige Name der Log-Datei mit Pfadangabe.
   Wenn *ssLogFileName* ein leerer String ist, wird die Log-Datei geschlossen.
   Die aktive Log-Datei wird auch geschlossen, wenn man einen neuen Dateinamen
   angibt.

.. us.comment

**Kommentar**

Die Log-Datei enthält für jede Zeile einen Log-Eintrag der Form:

::

   [06.12.2005 14:19:33] [uniscript] [error] [] [test]

Die Log-Datei enthält 5 Felder pro Zeile:

.. list-table::
   :header-rows: 0

   * - Feld 1
     - Datum Zeit
   * - Feld 2
     - Logger-Name
   * - Feld 3
     - level (trace,debug,warning,error,fatal)
   * - Feld 4
     - Quelle
   * - Feld 5
     - Meldung

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Neu

.. seealso::
   :ref:`overview-logging`,
   :ref:`log_get_filename`,
   :ref:`log_info <log_error>`

:sub:`id-713320`