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 | ```` |