_LOGMINLEVEL

The _LOGMINLEVEL function returns the current minimum logging level that is being output.

Syntax

level& = _LOGMINLEVEL

Parameters

• The return value level& is a number from 1 to 5 indicating the current minimum level of logging enabled. The below table indicates the mapping:

┌────────┬─────────────┐ │ Number │ Log level │ ├────────┼─────────────┤ │ 1 │ Trace │ ├────────┼─────────────┤ │ 2 │ Information │ ├────────┼─────────────┤ │ 3 │ Warning │ ├────────┼─────────────┤ │ 4 │ Error │ ├────────┼─────────────┤ │ 5 │ None │ └────────┴─────────────┘

Description

• The purpose of _LOGMINLEVEL is to allow programs to skip generating expensive logging if that logging would not be output anywhere.
• For example, you may have a very large array of integers that you want to log fairly often - generating the strings of the log messages for that array can slow down your program even if those messages are ultimately never written anywhere. By checking _LOGMINLEVEL before generating those log messages you can avoid that expensive work if it would not be used but also still produce it when you request it.
• If the function returns a 2, that indicates that only logging at the Information level and above is being captured somewhere. If the function returns a 5, that means no logging is being captured anywhere.

Availability

• 

  no

• 

  v4.0.0

• 
• 

  yes

• 

  yes

• 

  yes

Examples

Example 1

Writes a log message at the information level

level& = _LOGMINLEVEL IF level& < 2 THEN ' Generate expensive log messages _LOGTRACE expensiveLogMessage$ END IF

See also

• _LOGTRACE, _LOGINFO
• _LOGWARN, _LOGERROR
• Logging

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link