.. highlightlang:: us

.. index:: log_set_level

.. _log_set_level:

log_set_level
=============

.. us.tag  log_set_level NOTREADYENGLISH New500 Programming.Logging

:ref:`log_set_level` sets the output level for the given logger.

.. function::  bool = log_set_level(ssLogger, level)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: ssLogger

   *ssLogger* is the logger name.

.. uparam:: level

   *level* is the level:

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

      * - LOG_TRACE (100)
      * - LOG_DEBUG (200)
      * - LOG_INFO (300)
      * - LOG_WARNING (400)
      * - LOG_ERROR (500)
      * - LOG_FATAL (600)

   Only log messages which have an equal or higher level will be logged.

.. us.example

**Example**

::

   // Set all logger to level LOG_ERROR. Only errors and fatal errors will
   // be logged.
   sv = log_get_logger_names();
   for (i in 1:len(sv) {
       log_set_level(sv[i], LOG_ERROR);
   }

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - New

.. seealso::
   :ref:`overview-logging`,
   :ref:`log_get_level`

:sub:`id-275424`