.. highlightlang:: us

.. index:: log_set_filename

.. _log_set_filename:

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

.. us.tag  log_set_filename NOTREADYENGLISH New500 Programming.Logging

:ref:`log_set_filename` sets a file name of the output file for all loggers.

.. function::  bool = log_set_filename(ssLogFileName)

.. us.return

**Return Value**

*bool* is TRUE (1) if the function was successful and otherwise FALSE (0).

.. us.params

**Parameters**

.. uparam:: ssLogFileName

   *ssLogFileName* is the complete name of a log file.
   If *ssLogFileName* is an empty string the log file will be closed.
   The active log file will also be closed if a new name is specified.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - New

.. seealso::
   :ref:`overview-logging`,
   :ref:`log_get_filename`,
   :ref:`log_info`

:sub:`id-713320`