Project

General

Profile

Logging Guidelines » History » Version 1

Vince Lehman, 09/08/2014 12:51 PM

1 1 Vince Lehman
Logging Guidelines
2
==================
3
4
## Log Levels
5
6
NONE:  no messages
7
8
ERROR: used to notify the user of an unexpected or failed event during process execution
9
10
WARN:  used to notify the user of events that may affect the process or to notify the developer of unusual variable values
11
12
INFO:  used to notify the user of major process events
13
14
DEBUG: used to notify the developer of important variable values and minor process events
15
16
TRACE: used to notify the developer of method calls and less important variable values
17
18
ALL:   all messages
19
20
## Example
21
````cpp
22
bool isFoo(int arg)
23
{
24
  _LOG_TRACE("isFoo(" << arg << ")");
25
26
  if (arg < 0) {
27
    _LOG_ERROR("arg is less than 0! arg must be greater than 0!");
28
    return false;
29
  }
30
  else if (arg < 10) {
31
    _LOG_WARN("It is unusual for arg to be less than 10");
32
  }
33
34
  g_value += arg;
35
  _LOG_DEBUG("g_value == " << g_value);
36
37
  _LOG_INFO("The return of this method is true and is important.");
38
  return true;
39
}
40
````